home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / rm900806.zip / RBBSMAIL.DOC < prev    next >
Text File  |  1990-08-06  |  101KB  |  2,572 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                       RBBSMail, the RBBS-PC Echomail Processor
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                                        (C) by Jan R.  Terpstra
  24.  
  25.  
  26.                                                                 August 6, 1990
  27.  
  28.  
  29.                                                                  Bamestra RBBS
  30.                                                                     P.O.Box 66
  31.                                                              1462 ZH  Beemster
  32.                                                                The Netherlands
  33.                                                              RBBSNet 8:998/1.0
  34.                                                             FIDONET 2:512/10.0
  35.                                                          phone1 ++31 2998 3602
  36.                                                    phone2 ++31 2998 3603 (HST)
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                                      Document Number RM_900806
  46.  
  47.  
  48.  
  49.                                                                               
  50.   │ Revisions in this document are marked by a sidebar like  the  one  on  the
  51.   │ left of this sentence. 
  52.  
  53.  
  54.  
  55.     
  56.  
  57.  
  58.     1. What is RBBSMail
  59.  
  60.  
  61.     RBBSMail is a program that allows sysops of  RBBS-PC  bulletin  boards  to
  62.     hook their bulletin board into the international FIDONET  and  participate
  63.     in Echomail.  The combination  RBBS-PC  +  RBBSMail  +  any  of  the  mail
  64.     frontends will process messages entered in designated conferences  of  the
  65.     RBBS-PC system and  send  those  messages  to  any  other  system  in  the
  66.     FIDONET.  It will put received Echomail in  the  proper  RBBS-PC  MESSAGES
  67.     file or FIDO style message subdirectory. 
  68.  
  69.     This way, RBBS-PC conferences can be shared  among  multiple  RBBS-PC  and
  70.     other systems in the FIDONET.  Messages entered on  any  of  the  bulletin
  71.     boards in an Echomail net will eventually be copied over to all the  other
  72.     bulletin board  systems  connected  to  the  net.   RBBSMail  does  handle
  73.     reception of directly addressed FIDONET  messages  but  it  cannot  handle
  74.     explicitly addressed messages from users on  your  system  simply  because
  75.     RBBS-PC does not (yet??) provide a way  of  addressing  network  messages.
  76.     RBBSMail can only process Echomail. 
  77.  
  78.   │ To accomodate bulletin board systems that run another BBS program next  to
  79.   │ RBBS-PC, RBBSMail can also do Import, Export and Maint functions  on  FIDO
  80.   │ style  message  subdirectories,  just  like  ConfMail,  QM  and  Dutchie's
  81.   │ Conference manager do.  This allows a mixed environment where both RBBS-PC
  82.   │ and FIDO or Opus can participate in Echomail on a single system. 
  83.  
  84.  
  85.     1.1  Software Requirements
  86.  
  87.  
  88.     To run RBBSMail, you need (of course) a  working  RBBS-PC  based  bulletin
  89.     board with a version of RBBS-PC that  will  run  with  a  frontend  mailer
  90.     (RBBS-PC v16.1A or later), RBBSMail and suitable  batch  files.   RBBSMail
  91.     can handle RBBS-PC MESSAGES files produced by RBBS-PC v12.5A  and  higher,
  92.     but you will have to take special actions to  have  your  frontend  mailer
  93.     operate with pre 16.1A versions. 
  94.  
  95.     RBBSMail will work happily  with  all  three  front-end  mailers  d'Bridge
  96.     BinkleyTerm or Dutchie.  Dutchie has DutchEd, the  nicest  message  editor
  97.     I've ever seen, and the Dutchie manual has a very educational  section  on
  98.     FIDONET basics. 
  99.     As all programs have strong and week points, it is up  to  you  to  decide
  100.     which one to use.  BinkleyTerm with MSGED is recommended!
  101.  
  102.     Mail notification, sysop alias and message security levels were introduced
  103.     in RBBS-PC v16.1A.  These features are supported  in  RBBSMail,  but  they
  104.     will not work with earlier versions of RBBS-PC.   However,  RBBSMail  will
  105.     run with pre-16.1A versions of  RBBS-PC  without  any  problems,  and  can
  106.     handle MESSAGE file formats of RBBS-PC v12.5A and later. 
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.     What is RBBSMail                                                         1
  115.  
  116.  
  117.  
  118.     
  119.  
  120.  
  121.     1.2  Hardware Requirements
  122.  
  123.  
  124.     The minimum hardware requirements to run RBBSMail are the  same  as  those
  125.     for RBBS-PC (think about that for a while....)
  126.  
  127.  
  128.     1.3  Related Documents
  129.  
  130.  
  131.     I advise you (well,it is sort of mandatory) to read  or  at  least  browse
  132.     through the following documents:
  133.  
  134.     ■   The manual of your frontend mailer ( BinkeyTerm, Dutchie or d'Dridge)
  135.     ■   SD-APDX by Kim Wells (how to run SEADOG with RBBS-PC). 
  136.     ■   BT-APDX by Tony Young (how to run BinkleyTerm with RBBS-PC). 
  137.     ■   BinkRBBS, by Jim Oswell. 
  138.     ■   The IFNA FSC documents. 
  139.     ■   IFNA publications about the FIDONET. 
  140.     ■   The FIDO newsletters. 
  141.     ■   The ConfMail documentation. 
  142.  
  143.     And you already read the RBBS-PC documentation, didn't you??? Or  did  you
  144.     just fire up RBBS-PC with your fingers crossed? IF you are  one  of  those
  145.     who never reads documentation, you'll probably will not read  this.   But,
  146.     in case your eye accidentially catches this: Please read the documentation
  147.     before you ask any questions!!! I have had too  many  questions  asked  by
  148.     people that obviously did not read a scrap of  documentation  before  they
  149.     started what they were doing and  I  have  a  standard  answer  for  these
  150.     people: R.T.F.M.!! (abbreviation  for  Read  The  F***ing  Manual).   This
  151.     answer usally solves about 95% of the questions.  The other 5% are  'real'
  152.     problems that need some sort of action.  If, after reading  and  rereading
  153.     the documentation, there are still  questions  unanswered,  feel  free  to
  154.     elaborately commentate on your problem. 
  155.  
  156.  
  157.     1.4  Acknowledgements
  158.  
  159.  
  160.     It is utterly impossible to give credits were credits are  due,  but  here
  161.     are the names of some persons that have been of  great  help  and  deserve
  162.     kudos: Thom Mack, Ken Goosens and Jon Martin, authors  of  RBBS-PC.   Doug
  163.     Azzarito and Kim Wells for their many suggestions.  Jeff Rush,  author  of
  164.     TOSSMAIL and SCANMAIL, and the inventor of Echomail.   The  Binkley  Trio.
  165.     Johan Zwiekhorst for GUS and ARCA.  Special thanks to Richard  Couture  of
  166.     SFPCug and Jim Oswell for beta-testing my silly code. 
  167.  
  168.  
  169.     1.5  Legal stuff
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.     What is RBBSMail                                                         2
  178.  
  179.  
  180.  
  181.     
  182.  
  183.  
  184.     1.6  Copyrights & License
  185.  
  186.  
  187.     RBBSMail is (C) Copyright 1988, 1989, 1990 by Jan R.  Terpstra. 
  188.     You are granted a limited license to use, copy and distribute RBBSMail  on
  189.     these conditions:
  190.  
  191.     1.  You may use the program for any commercial or non-commercial  purpose.
  192.         Use it on your company, private or school BBS, feed it to your dog, or
  193.         use it as a doorstop.  I don't care. 
  194.     2.  You may copy and distribute as many copies  of  this  program  as  you
  195.         like, provided you do not charge money  for  the  program  itself.   A
  196.         small fee (for copying, handling, mailing and  the  diskette  carrying
  197.         the copy) is allowed, but  this  amount  shall  not  exceed  the  real
  198.         costs.  (i.e.  you may not make profit by distributing RBBSMail). 
  199.     3.  The program and documentation shall not bee modified in any way. 
  200.     4.  You shall abide by the DINNERWARE concept.  If you  use  this  program
  201.         take your wife or girlfriend (not both) out to dinner at least once. 
  202.  
  203.     If you absolutely insist on spending money for  RBBSMail,  DO  NOT  put  a
  204.     check in the mail to me.  In stead, take  your  wife  or  girlfriend  (not
  205.     both) out to dinner, to make up for the many,  many  hours  you  left  her
  206.     alone while you were playing around with your BBS....... 
  207.     Therefore, it is understood that RBBSMail is distributed as DINNERWARE
  208.     You may also consider a donation ($20 suggested) a local charity  of  your
  209.     choice.  If that idea does not appeal to you, send me a postcard from your
  210.     next vacation (no windmills please!) or a picture of yourself in front  of
  211.     your BBS computer.  Christmas cards are also greatly appreciated!
  212.  
  213.  
  214.     1.7  Warranty
  215.  
  216.  
  217.     You must be kidding? No warranty of any kind is given on RBBSMail,  except
  218.     that the documentation is guaranteed to be in poor English. 
  219.     You use this program AT YOUR  OWN  RISK.   For  your  info:  RBBSMail  was
  220.     developed and tested on an IBM PS/2 mod70 with 4MB memory and a 60MB fixed
  221.     disk.  This version has been tested with  RBBS-PC  17.2B,  ConfMail  v3.3,
  222.     BinkleyTerm v2.30, oMMM v1.40 and AMAX v2.20. 
  223.  
  224.     The program is written in BASIC and  compiled  with  the  Microsoft  BASIC
  225.     Compiler  v6.00.   The  assembler  subroutines  were  assembled  with  the
  226.     MicroSoft Macro Assembler v5.10.  All development  and  testing  was  done
  227.     under IBM PC-DOS 3.30 and DESQView 2.22.  I'm not sure if it is of any use
  228.     to you, but you CAN run RBBSMail in the OS/2(tm) DOS 'penalty box'. 
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.     What is RBBSMail                                                         3
  241.  
  242.  
  243.  
  244.     
  245.  
  246.  
  247.     2. Installation
  248.  
  249.  
  250.     2.1  Configuring RBBSMail
  251.  
  252.  
  253.     Installation of RBBSMail  is  pretty  straightforward.   The  installation
  254.     procedure assumes that  you  have  installed  RBBS-PC  and  your  frontend
  255.     mailer, with all the conferences, the RBBS-PC control files  and  suitable
  256.     batch files.  You should already have obtained all the stuff you  need  to
  257.     run as a FIDONET node, things like NET/NODE number, the NODELIST and  some
  258.     programs to maintain all the files.  Please read the documentation of your
  259.     frontend mailer about this.  Talk to the Sysop  of  your  host-node  about
  260.     setting up your mail schedules and mailrouting. 
  261.  
  262.     Now, copy RBBSMail.EXE to  the  directory  where  you  keep  your  RBBS-PC
  263.     MESSAGE files.  Find out the EXACT filenames of all  the  conferences  you
  264.     are going to hook up in the Echomail and find out by what AREA:names  they
  265.     are known in the network you are participating  in.   You  also  need  the
  266.     NET/NODE number(s) of the system(s) you are going send Echomail  to.   You
  267.     can send any AREA: to a  large  number  of  different  systems.   This  is
  268.     usually not the case, you will  probably  only  exchange  mail  with  your
  269.     Echomail host. 
  270.  
  271.     Most local FIDONET nets have a single hostnode with some 5 to 20 connected
  272.     nodes.  Ask the sysop of your local or regional host for the  EXACT  AREA:
  273.     names used in your net. 
  274.     This version of RBBSMail can run your system as Echomail host, you can set
  275.     up your own local or regional net. 
  276.  
  277.     If you have all this info, you have to generate at  least  two  files  for
  278.     RBBSMail.  One is RBBSMAIL.CFG and it contains  the  information  RBBSMail
  279.     needs to make your system talk to the rest of the net.  We'll  talk  about
  280.     the other file later.  The format of the  .CFG  file  is  similar  to  the
  281.     configuration files used by the frontend mailers. 
  282.  
  283.  
  284.     2.2  Valid phrases for RBBSMAIL.CFG
  285.  
  286.  
  287.     Some changes were made in RBBSMail 17.3A to accomodate direct  reading  of
  288.     BinkleyTerm's configuration file.  The following configuration phrases are
  289.     now obsolete:
  290.  
  291.     NODE      This phrase is replaced by the ADDRESS verb. 
  292.     AKA       This phrase is replaced by the ADDRESS verb. 
  293.     MAIL      This phrase is replaced by the NETMAIL verb. 
  294.     FILE      This phrase is replaced by the NETFILE verb. 
  295.     POINT     This phrase is replaced by the PRIVATENET verb. 
  296.  
  297.  
  298.     The new valid phrases are listed below:
  299.  
  300.  
  301.  
  302.  
  303.     Installation                                                             4
  304.  
  305.  
  306.  
  307.     
  308.  
  309.  
  310.     2.2.1  ADDRESS
  311.  
  312.     Up to 10 FULL ZONE:NET/NODE.POINT address.  For normal operation, the full
  313.     FIDONET address(es) under which you are listed in the nodelist.  For point
  314.     operation, it is the full address of the BOSS, except for the last address
  315.     part, which should be the pointnumber assigned by the Boss, i.e.  the full
  316.     4 dimensional address.  For point operation, RBBSMail will  translate  the
  317.     address internally to the proper fakenet address. 
  318.     You may have up to 10 extra addresses (AKA, Also Known As addresses).  The
  319.     extra addresses are ignored for point operation.  The FIRST address listed
  320.     in the configration file will be used as your primary address.  Additional
  321.     addresses are Ignored for POINT operation. 
  322.  
  323.  
  324.   │ 2.2.2  DOMAIN
  325.  
  326.   │ This is the common name of the network you are  a  member  of  under  your
  327.   │ PRIMARY net/node number.  DOMAIN is used to  build  the  MSGID:  tafs  for
  328.   │ messages originating from your system and can be any valid domain name&gml
  329.   │ RBBSNet, FIDONET, Eggnet, AlterNet or whatever network you are in. 
  330.  
  331.  
  332.     2.2.3  NETMAIL
  333.  
  334.     tells RBBSMail  the  subdirectory  where  it  can  find  incoming/outgoing
  335.     netmail. 
  336.  
  337.  
  338.     2.2.4  NETFILE
  339.  
  340.     Subdirectory where RBBSMail can find the incoming mailbundles. 
  341.  
  342.  
  343.     2.2.5  HOLD
  344.  
  345.     Where Binkley/oMMM compatible mailbundles go.   When  the  -O  commandline
  346.     switch is given, RBBSMail will store outgoing mail  in  this  directoy  as
  347.     .OUT bundles  in  stead  of  regular  FIDO  style  messages  in  the  MAIL
  348.     directory.  This saves one step in packing  and  squeezing  your  outgoing
  349.     mail. 
  350.  
  351.  
  352.     2.2.6  DUPS
  353.  
  354.     When RBBSMail finds a duplicate  message,  this  is  the  directory  where
  355.     RBBSMail moves the duplicate to.  Mailbundles that could not  be  properly
  356.     unbundled will also be moved to this directory. 
  357.  
  358.  
  359.     2.2.7  WORKDIR
  360.  
  361.     Drive and path where RBBSMail can save intermediate files.  The  available
  362.     space in the working directory should be large enough to hold the  largest
  363.     message file that is on your  system.   Using  a  VDISK  for  the  working
  364.  
  365.  
  366.     Installation                                                             5
  367.  
  368.  
  369.  
  370.     
  371.  
  372.  
  373.     directory improves the speed of RBBSMail SCAN. 
  374.  
  375.  
  376.     2.2.8  PRIVATENET
  377.  
  378.     Is the NETnumber of your private network for points.  RBBSMail will  strip
  379.     all point addresses from the SEEN-BY: lines in outgoing mail, but  retains
  380.     the addresses locally.  The PRIVATENET MUST be the  HIGHEST  netnumber  in
  381.     your list.  PRIVATENET is mandatory for both Boss AND point operation. 
  382.  
  383.  
  384.     2.2.9  SIZE
  385.  
  386.     Maximum size (in BYTES) of incoming messages.   Any  message  larger  than
  387.     this will be  ignored.   RBBSMail  (i.e.   BASIC)  does  not  have  enough
  388.     dataspace to process messages that are over 15KB in size.  10240 bytes  is
  389.     a good value, maximum is 15000. 
  390.  
  391.     Note: Most sysops pay the bill for Echomail out of their  own  pocket,  so
  392.     messages in the Echomail should be kept small.  Sending Echomail  messages
  393.     that are over 10KB in size may be considered anti-social..... 
  394.  
  395.  
  396.     2.2.10  DBCS
  397.  
  398.     This tells RBBSMAIL to operate  in  "Double  Byte  Character  Set"  (DBCS)
  399.     mode.  See Appendix B for details. 
  400.  
  401.  
  402.     2.2.11  SYSALIAS
  403.  
  404.     The alias name sysop uses to logon remotely to  RBBS-PC.   Beginning  with
  405.     RBBS-PC v16.1A, the sysop's alias  name  is  listed  in  the  USERS  file.
  406.     RBBSMail needs to know this alias to find the sysop  entry  in  the  USERS
  407.     file to be able to flip the 'mail waiting' indicator for the sysop. 
  408.  
  409.  
  410.     2.2.12  SYSOP
  411.  
  412.     The name you are normally known under as sysop of this  system.   Whatever
  413.     you specify here will be overridden if you specify a SYSOP name after  the
  414.     ORIGIN line in AREAS.BBS. 
  415.  
  416.  
  417.     2.2.13  SECURITY
  418.  
  419.     The security all imported messages are set to.  A  user  has  to  have  at
  420.     least this access level  to  read  any  imported  Echomail.   Ignored  for
  421.     messages in FIDO style message subdirectories. 
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.     Installation                                                             6
  430.  
  431.  
  432.  
  433.     
  434.  
  435.  
  436.     2.2.14  GATE
  437.  
  438.     ZONE:NET/NODE of a ZONEgate or ECHOgate  (HUB)  you  exchange  mail  with,
  439.     followed by the NET/NODE numbers (NOT  the  zone  numbers!!)  that  should
  440.     ALWAYS appear in the SEEN-BY lines in messages addressed to  that  gateway
  441.     node.  Normally, the SEEN-BY line to an ECHOgate or ZONEgate  should  only
  442.     contain the gate's NET/NODE and the NET/NODE of your own system (and  your
  443.     AKA addresses, if applicable).  Ignored for point operation. 
  444.     If you are serving as Echomail hostsystem and also send echoes to the host
  445.     of another net, you and the other  hosts  are  only  concerned  about  the
  446.     SEEN-BY info for your own nets, and there is no reason to tell the host of
  447.     the other net all of your SEEN-BY info.  The two host systems only have to
  448.     tell each other the fact that they have seen the message,  but  all  other
  449.     info about what happened to the message in the one net, is of no  interest
  450.     to the other net.  Having a short SEEN-BY line keeps down the mailcost for
  451.     ZONE and ECHO gates. 
  452.     In all cases, the NET/NODE numbers  in  the  prefabricated  SEEN-BY  lines
  453.     should be in numeric order, without the ZONE numbers, typed with one space
  454.     in between, exactly as they should appear in the SEEN-BY  line.   You  may
  455.     define up to 25 gates. 
  456.  
  457.  
  458.     2.2.15  PACK
  459.  
  460.     The name of a BATchfile or program to be called by RBBSMail to packup your
  461.     outgoing mail.  This normally calls oMMM, Dutchie's PACKER  or  a  similar
  462.     mail packing program to bundle and route outgoing mail.  See also the  -M:
  463.     switch. 
  464.  
  465.     The program listed after PACK can be a BATchfile that  invokes  your  mail
  466.     packer or just the name and parameters of your mail packer.  A PACK  batch
  467.     file (for example named PACKMAIL.BAT) can look something like this if  you
  468.     use BINKLEY and oMMM:
  469.  
  470.       ECHO OFF
  471.       CD\BT
  472.       oMMM -iBINKLEY.PRM -m\BT\MAIL -h\BT\HOLD -c\BT\OMMM.CTL -sA -z2
  473.       CD\RBBS
  474.  
  475.     In this case, the RBBSMail entry should read
  476.  
  477.       PACK  C:\PACKMAIL.BAT
  478.  
  479.     Or the PACK parameter could list only the oMMM program with parameters:
  480.  
  481.       PACK  oMMM -i\BINKLEY.PRM -m\BT\MAIL -h\BT\HOLD -c\BT\OMMM.CTL -sA -z2
  482.  
  483.     In this case, RBBSMail calls oMMM directly and you do not need a  separate
  484.     BATchfile to run oMMM. 
  485.  
  486.  
  487.     Note: If you decide to use this RBBSMail feature, BE SURE you have  enough
  488.     memory to run RBBSMail, oMMM and ARCA on top of  each  other!  320KB  free
  489.     memory when starting RBBSMail with this feature is the bare minimum. 
  490.  
  491.  
  492.     Installation                                                             7
  493.  
  494.  
  495.  
  496.     
  497.  
  498.  
  499.     2.2.16  UNPACK
  500.  
  501.     The program or batch file RBBSMail should call to  decompress  compressed
  502.     mailbundles (i.e.  ARCmail, ZIPmail, ZOOmail). 
  503.  
  504.     Today, it is very common to compress mailbundles before they are  sent  to
  505.     another system.  This will in some cases save over 50% of connect time  to
  506.     transfer mailbundles.  RBBSMail recognizes compressed mailbundles and will
  507.     call the uncompress program  that  is  listed  at  the  UNPACK  phrase  to
  508.     uncompress the compressed mailbundles before unbundling them into separate
  509.     messages. 
  510.     If your system only processes one style of compressed mail, UNPACK  should
  511.     list the unarchive program (ZOO.EXE, ARCE.COM,  PKUNZIP.EXE,  or  whatever
  512.     exotic variety you use). 
  513.  
  514.     If your system receives different kinds of compressed mail, use an  unpack
  515.     shell like GUS, the General Unpack Shell,  written  by  Johan  Zwiekhorst.
  516.     GUS will look at the compressed file it has to uncompress  and  then  call
  517.     the  appropriate  uncompress  program.   In  combination  with  the   ARCA
  518.     simulator (by the same author), you can make  a  very  flexible  setup  to
  519.     send/receive any kind of compressed mailbundles. 
  520.  
  521.  
  522.     2.2.17  ELASTIC
  523.  
  524.     Set this configuration option if you use RBBS-PC v17.2A or later  AND  you
  525.     have configured RBBS-PC to use MESSAGES files that  are  growing  in  size
  526.     when messages are added.  This greatly improves  the  way  in  which  your
  527.     precious disk space is used and it will make RBBSMail a bit faster on SCAN
  528.     runs.  RBBSMail will not be bothered by a filled up MESSAGES file. 
  529.  
  530.  
  531.   │ 2.2.18  NOFORWARD
  532.  
  533.   │ All NETmail messages that do not originate from your  system  on  are  not
  534.   │ sent out to other systems.  Some people make a habit of  sending  messages
  535.   │ to the other side of the world by delivering the messages to  your  system
  536.   │ and have YOU make  the  expensive  call.   Messages  originating  from  or
  537.   │ addressed  to  systems  in  your  PRIVATENET  will  always  be  forwarded.
  538.   │ NOFORWARD is ignored for ZONEGATE operation. 
  539.  
  540.  
  541.   │ 2.2.19  NOFILES
  542.  
  543.   │ This will prevent file attaches, file requests and  file  update  requests
  544.   │ from other systems to be sent on your dime.   Mail  is  forwarded  from/to
  545.   │ other systems, attached files and file-requests  are  not.   Inbound  file
  546.   │ attaches to the private network are retained. 
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.     Installation                                                             8
  556.  
  557.  
  558.  
  559.     
  560.  
  561.  
  562.   │ 2.2.20  UNCRASH
  563.  
  564.   │ Forward mail for other systems, but always reset the CRASHmail bit. 
  565.  
  566.  
  567.   │ 2.2.21  ZONEGATE
  568.  
  569.   │ The zonenumber you are the zonegate for.  If your system is in zone 2  and
  570.   │ your system is the zonegate for zone  3,  set  ZONEGATE  3.   See  section
  571.   │ "Zonegate Operation" for information about setting up a Zonegate.  Ignored
  572.   │ for POINT operation. 
  573.  
  574.  
  575.   │ 2.2.22  Reading BINKLEY.CFG
  576.  
  577.   │ RBBSMail is also capable of directly reading  BinkleyTerm's  configuration
  578.   │ file.  If RBBSMail cannot find the file RBBSMAIL.CFG, it will look for the
  579.   │ file BINKLEY.CFG in the subdirectory pointed to  by  the  DOS  environment
  580.   │ variable "BINKLEY". 
  581.   │ The configuration phrases  Address,  Netmail,  Netfile,  Hold,  Sysop  and
  582.   │ Privatenet are read directly from Binkleyterm's configuration file. 
  583.   │ The phrases Dups, SysAlias, Size, Elastic, Security, Gate,  Pack,  Unpack,
  584.   │ WorkDir and DBCS should be added to  BINKLEY.CFG  by  putting  APPLICATION
  585.   │ RBBSMAIL in front of the configuration phrase. 
  586.   │ For example, to enter the SECURITY phrase in BINKLEY.CFG, add the line:
  587.  
  588.   │    Application RBBSMail Security 4
  589.  
  590.   │ See the BinkleyTerm documentation for more info. 
  591.  
  592.   │ Note: As RBBSMAIL cannot read nested configuration files, you  cannot  use
  593.   │ the INCLUDE statement in your BINKLEY.CFG file. 
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.     Installation                                                             9
  619.  
  620.  
  621.  
  622.     
  623.  
  624.  
  625.     2.2.23  Example of a RBBSMAIL.CFG file
  626.  
  627.  
  628.       ; Lines starting with a ';' are comment lines.  BLANK lines are ignored.
  629.       ;
  630.       ADDRESS    2:512/10.0
  631.       ADDRESS    2:512/101.0
  632.       ADDRESS    8:998/1.0
  633.       ADDRESS    8:998/0.0
  634.       DOMAIN     FIDONET
  635.       NETMAIL    C:\BT\NETMAIL\
  636.       NETFILE    C:\BT\NETFILES\
  637.       HOLD       C:\BT\HOLD\
  638.       PRIVATENET 1234
  639.       DUPS       C:\BT\DUPMSGS\
  640.       SYSALIS    Buck Rogers
  641.       SYSOP      John Sysop
  642.       SIZE       9000
  643.       ELASTIC
  644.       SECURITY   4
  645.       GATE       1:1/0  1/0 512/10 101
  646.       GATE       2:2/0  2/0 512/10 101
  647.       GATE       3:3/0  3/0 512/10 101
  648.       GATE       8:8/0  8/0 512/10 926/0 1
  649.       PACK       C:\BINKLEY\PACKMAIL.BAT
  650.       UNPACK     GUS.EXE
  651.       NOFILES
  652.       UNCRASH
  653.       ZONEGATE 3
  654.  
  655.     (another example is included in this package, see file EXAMPLE.CFG). 
  656.     Put the config file RBBSMAIL.CFG in your RBBS-PC directory. 
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.     Installation                                                            10
  682.  
  683.  
  684.  
  685.     
  686.  
  687.  
  688.     The second file you need is named AREAS.BBS (for historic reasons).   This
  689.     file lists all the conferences you want to hook up to Echomail, the  AREA:
  690.     tag for that conference and the NET/NODE  number  you  want  to  send  the
  691.     Echomail to. 
  692.  
  693.  
  694.     2.2.24  Example of an AREAS.BBS file
  695.  
  696.  
  697.       ; Lines starting with ';' or '-' are comment lines, so are BLANK lines
  698.       ; First non-commented line has the ORIGIN line ! optional SYSOP name
  699.       The Tennis Court, Herejezusveen, The Netherlands ! John Sysop
  700.       ; all subsequent lines have either
  701.       ;   RbbsFileName  AreaName  SendToList  PrivateModifier
  702.       ; or
  703.       ;   MsgSubdir     AreaName              PrivateModifier
  704.       ;
  705.       ; You should at least have AREA:GENERAL and AREA:PRIVATE.
  706.       ; Per conference, you can have up to 100 netnumbers with each 100
  707.       ; nodes.  This is sufficient for 10000 nodes, more then you will
  708.       ; be able to exchange mail with during the national mail hour.....
  709.       C:\RBBS\MESSAGES    GENERAL
  710.       C:\RBBS\MESSAGES    PRIVATE
  711.       C:\RBBS\TENNISM.DEF TENNIS  2:512/1 2 8:926/1 8:999/1 2:1234/1 2  -
  712.       C:\RBBS\IBMPCM.DEF  IBM-PC  2:512/1 2 3 12 8:926/1                -
  713.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1                     +
  714.       C:\BINK\SYSOPS\     SYSOP   2:512/1
  715.  
  716.     (see also EXAMPLE.BBS in this package). 
  717.  
  718.     This AREAS.BBS example will have the following result:
  719.  
  720.     ■   The string "The Tenniscourt, Herejezusveen, The Netherlands"  will  be
  721.         used as the * Origin: line in all outgoing Echomail  originating  from
  722.         your system.  This way, anybody on any other system  will  know  where
  723.         the message was originally entered. 
  724.  
  725.     ■   If an outgoing message has SYSOP in the  address  field,  it  will  be
  726.         replaced by the name John Sysop.  This way, other sysops will not find
  727.         that message addressed to themselves, avoiding confusion. 
  728.         If you specify the OPTIONAL sysop name this way, it will overrride the
  729.         SYSOP entry of RBBSMAIL.CFG. 
  730.  
  731.     ■   If an incoming message has John Sysop in the address field, it will be
  732.         replaced by SYSOP.  This way, the message  scan  function  of  RBBS-PC
  733.         will identify those messages as being addressed to SYSOP. 
  734.  
  735.     ■   Your MAIN RBBS-PC MESSAGES file will receive  all  the  incoming  mail
  736.         that is directed to the area's GENERAL and PRIVATE.  All messages with
  737.         a PRIVATE tag will be put in the MESSAGES files as private files. 
  738.  
  739.     ■   All messages in the file TENNISM.DEF will be sent to nodes  512/1  and
  740.         512/2 in ZONE 2, to nodes 926/1 and 999/1 in zone 8, and they will  be
  741.         sent to the nodes in the private (point) network  1234/1  and  1234/2.
  742.  
  743.  
  744.     Installation                                                            11
  745.  
  746.  
  747.  
  748.     
  749.  
  750.  
  751.         When sent out, an AREA: tag TENNIS will be put in the  first  line  of
  752.         the message.  This way the receiving system on  the  other  end  knows
  753.         what to do with the message.  When importing incoming  mail,  messages
  754.         with an AREA: tag TENNIS will be put in the TENNISM.DEF file. 
  755.  
  756.     ■   The area SYSOPS does not refer to an RBBS-PC MESSAGES file, but  to  a
  757.         subirectory that  holds  FIDO  style  messages.   If  a  message  with
  758.         AREA:SYSOPS  is  received,  it  will  be  moved  to  the  subdirectory
  759.         C:\BINK\SYSOPS\, where it can be read by an appropriate message editor
  760.         like MsgEd  or  Dutchie's  Editor.   RBBSMail  "sees"  the  difference
  761.         between RBBS-PC MESSAGES files and FIDO subdirectories by looking  the
  762.         filename.  If a  filename  is  listed,  a  RBBS-PC  MESSAGES  file  is
  763.         assumed.   If  a  subdirectory  is  listed  (i.e.   with  a   trailing
  764.         backslash), RBBSMail will treat the conference as a FIDO style message
  765.         subdirectory. 
  766.  
  767.     ■   You can probably figure out by yourself what happens to the other  two
  768.         conference files RBBS-PC and IBM-PC? Well, sort of...... 
  769.  
  770.     The last charcter '-' on the line defining the  RBBS-PC  conference  tells
  771.     RBBSMail that private messages left in that conference should not be  sent
  772.     out.  Also, all incoming private messages for that conference will not  be
  773.     TOSSed in the conference, but killed right away. 
  774.     The directive '+'  on  the  line  defining  the  TENNIS  conference  tells
  775.     RBBSMail to allow import  and  export  of  private  messages.   i.e.   the
  776.     message's attributes will remain unchanged. 
  777.     By default, RBBSMail will force all incoming and outgoing messages in  all
  778.     conferences to be PUBLIC messages. 
  779.  
  780.     AREA:PRIVATE and  AREA:GENERAL  will  never  be  changed  in  status,  but
  781.     messages addressed to SYSOP in those areas will  ALWAYS  be  made  private
  782.     messages. 
  783.  
  784.     This example has all your Echomail information in one file.  You may  have
  785.     different AREAS.BBS-type files with different names and  different  origin
  786.     lines.  For instance, you could have a TENNIS.BBS file like:
  787.  
  788.       The Tennis Court, Herejezusveen, The Netherlands ! John Sysop
  789.       C:\RBBS\TENNISM.DEF TENNIS  2:512/1 2 8:926/1 8:999/1 2:1234/1 2
  790.  
  791.     Or an IBMPC.BBS file with:
  792.  
  793.       The Tennis Court, IBM PC Tech support, The Netherlands ! John Sysop
  794.       C:\RBBS\IBMPCM.DEF  IBM-PC  2:512/1 2 3 12 8:926/1         -
  795.  
  796.     When you invoke RBBSMail SCAN explicitly giving  TENNIS.BBS  or  IBMPC.BBS
  797.     (see next chapter) it will take the  sysop  name,  origin  line  text  and
  798.     distribution info from that file.  This way, you can put different  things
  799.     in you ORIGIN line and process  Echomail  conferences  separately  and  at
  800.     different times. 
  801.  
  802.     Also, it is possible to have more than one RBBSMAIL.CFG file.  This  comes
  803.     in handy if your system is participating in more than one  NET.   You  can
  804.     set up multiple .CFG files and multiple .BBS files,  allowing  you  to  do
  805.  
  806.  
  807.     Installation                                                            12
  808.  
  809.  
  810.  
  811.     
  812.  
  813.  
  814.     different things with different files under  different  NET/NODE  numbers.
  815.     This is highly flexible, but you should take real good care  of  what  you
  816.     do.  You may completly clobber up your Echomail!!
  817.  
  818.     There is one additional file RBBSMail uses to store the serial numbers  it
  819.   │ uses to create the MSGIDs  it  adds  to  messages  originating  from  your
  820.   │ system.  This file,  RBBSMAIL.NUM  is  set  to  HIDDEN  and  READ_ONLY  by
  821.   │ RBBSMail.  You should not manually interfere with this file.  If  you  do,
  822.   │ the MSGID serial number scheme will get mixed up and it is  possible  that
  823.   │ messages originating from your system are treated as duplicate messages by
  824.   │ other systems. 
  825.  
  826.  
  827.     2.3  Setting up for POINT operation
  828.  
  829.  
  830.     What's a point? A point is basically  a  private  bulletin  board  system,
  831.   │ i.e.  a BBS with only one single user: the point-sysop.  A point is a  BBS
  832.   │ that does not exist in the public nodelist.  The point only exists in  the
  833.   │ "private network" of the BOSS node.  A point only  communicates  with  his
  834.   │ BOSS.  Any node in the nodelist can have points.  There is no formal point
  835.   │ addressing method in the FIDO compatible network, so a kludge was invented
  836.   │ to address points.  The addressing system for points works like this:
  837.  
  838.   │ Suppose node 2:512/10 wants to support points.  He then picks a  netnumber
  839.   │ for his private network, usually by adding 1000 to his  own  node  number.
  840.   │ All points under the Boss get a node number in this private network.   The
  841.   │ Boss maintains his own nodelist extension for his  private  network.   For
  842.   │ example, Boss 2:512/10 uses private network PRIVATENET 1010.  Point number
  843.   │ 3 then gets address 1010/3 in this private network. 
  844.  
  845.   │ Any message arriving at the Boss  from  point  number  3  in  the  private
  846.   │ network, will be run through a program that translates the point's private
  847.   │ network address to a public address.   After  this  translation  (commonly
  848.   │ known as 'address remapping'), a message from private net  address  1010/3
  849.   │ will appear to have been send from 2:512/10.  The remapping  program  will
  850.   │ add an FMPT tag to the body of the message.  Putting the BOSS ADDRESS  and
  851.   │ the POINT NUMBER together gives the full  "4  dimensional"  point  address
  852.   │ 2:512/10.3 (i.e.  point 3 in the private network of Boss 2:512/10). 
  853.   │ Another person on another node or point, sending a reply to that  message,
  854.   │ will add a TOPT 3 tag to the body of his reply.  When the reply arrives at
  855.   │ BOSS 2:512/10, the remapping program understands that the TOPT  tag  means
  856.   │ that the message is not for the Boss himself, but that it must  be  routed
  857.   │ to point number 3 in his private network.  The public  address  2:512/10.3
  858.   │ will be translated to node 1010/3 in the private network.  The  BOSS  node
  859.   │ will then take care of proper mail distribution in his private network. 
  860.  
  861.   │ The translation scheme described  above  applies  for  Echomail  too,  but
  862.   │ there's one other thing.  Because a point address  never  appears  in  the
  863.   │ public nodelist, the address listed in the origin line of a message should
  864.   │ be the public address of the point sending the message.  If the address in
  865.   │ the origin line is the point's address in the private network, the  origin
  866.   │ line wouldn't make much sense.  Usually nobody (except for the Boss) knows
  867.   │ whcich POINT addresses belong to whatever private network. 
  868.  
  869.  
  870.     Installation                                                            13
  871.  
  872.  
  873.  
  874.     
  875.  
  876.  
  877.   │ Therefore, the origin line in an Echomail message from a point should list
  878.   │ the extended public address.  This way, anyone wishing to reply to such  a
  879.   │ message with a direct message can find the full address of the  sender  in
  880.   │ the origin line. 
  881.   │ On the BOSS side, RBBSMail will  add  a  FMPT  tag  to  any  message  that
  882.   │ originated from a system in the private network.  This is  done  for  both
  883.   │ Echomail and netmail messages.  Address remapping is  also  done  for  all
  884.   │ incoming netmail adressed to systems in the private network.   FMPT  (from
  885.   │ point) and TOPT (to point) tags will be added to  all  messages  that  are
  886.   │ remapped. 
  887.   │ You do not need an external remapping program to forward mail to/from your
  888.   │ private network, RBBSMail takes care of the proper address translation. 
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.     Installation                                                            14
  934.  
  935.  
  936.  
  937.     
  938.  
  939.  
  940.     3. Running RBBSMail
  941.  
  942.  
  943.     First a word of caution for those of  you  running  a  multi-node  system.
  944.     RBBSMail uses a bit of an odd scheme to export mail.  During a  SCAN  run,
  945.     RBBSMail copies the RBBS-PC MESSAGES file it processes to a temporary file
  946.     named RBBSMAIL.$$$, erases the RBBS-PC MESSAGES file and then  copies  the
  947.     temporary file over to the original filename. 
  948.  
  949.     This scheme is likely to  cause  some  unwanted  (but  still  interesting)
  950.     side-effects on your network or multi-tasking supervisor, especially if  a
  951.     user on one of the active nodes joins a conference at the moment  RBBSMail
  952.     is scanning that conference. 
  953.  
  954.     Depending on the phase of the moon, relative humidity and  wind,  your  PC
  955.     will lock up or display Christmas decorations on your screen.   To  be  on
  956.     the safe side, you MUST bring down all nodes of your system when  RBBSMail
  957.     SCAN runs. 
  958.  
  959.     Beginning with version 17.3A, a number of safeguards have  been  build  in
  960.     RBBSMail to ensure RBBS-PC MESSAGES file integrity while TOSSing mail into
  961.     RBBS-PC style conferences.  You do not need to bring down all  your  nodes
  962.     when TOSSing mail.  You  can  have  users  reading  and  writing  messages
  963.     on-line while at the same time RBBSMail TOSSes  mail  in  to  the  RBBS-PC
  964.     conferences. 
  965.  
  966.     RBBSMail runs in four modes: TOSS, SCAN, MARK and MAINT. 
  967.  
  968.  
  969.     3.1  MARK mode
  970.  
  971.  
  972.     This is the command line to invoke the MARK mode:
  973.  
  974.       RBBSMail MARK:areaname -C:cfgfile -F:areasfile -MSG:#
  975.  
  976.  
  977.     Note: You can use either '-' or '/' as command delimiter. 
  978.     This mode will mark the RBBS-PC conference or the  FIDO  style  conference
  979.     for the supplied areaname as being echoed up to the messagenumber supplied
  980.     with the -MSG: switch.  For RBBS-PC conferences, the flagging is  done  by
  981.     changing the ':' (colon) between minutes and seconds in the DATE field  of
  982.     the RBBS-PC message to a '.' (dot). 
  983.  
  984.     Note: This has some unwanted  side  effects  on  RBBS-PC's  CONFIG  option
  985.     "repair MESSAGES files".  See appendix A  for  details.   For  FIDO  style
  986.     conferences, the marker is stored in the first message  (i.e.   1.MSG)  in
  987.     the subdirectory. 
  988.     RBBSMail MARK:TENNIS -MSG:34 marks the file TENNISM.DEF (that  is  related
  989.     to the AREA: tag TENNIS by the entry in the AREAS.BBSfile) as being echoed
  990.     up to message 34.  You should consider doing this one time  for  all  your
  991.     conference files before you start processing Echomail.  If you do not, the
  992.     first SCAN run of your  RBBS-PC  files  will  find  no  flagged  messages.
  993.     RBBSMail will assume that all messages in all files must be thrown out  on
  994.  
  995.  
  996.     Running RBBSMail                                                        15
  997.  
  998.  
  999.  
  1000.     
  1001.  
  1002.  
  1003.     the network.  Not very useful if you have messages a half year old..... 
  1004.  
  1005.     The -C: switch allows you to use an alernate  filename  for  RBBSMAIL.CFG.
  1006.     By explicitly giving a different filename for AREAS.BBS (-F: switch),  you
  1007.     can use an alternate filename for AREAS.BBS. 
  1008.  
  1009.  
  1010.     3.2  SCAN mode
  1011.  
  1012.  
  1013.     This is the command line to invoke the SCAN mode:
  1014.  
  1015.       RBBSMail SCAN -C:cfgfile -F:areasfile -AKA:# -L -M:# -O|OZ -R
  1016.  
  1017.  
  1018.     Note: You can use either '-' or '/' as command delimiter. 
  1019.     This mode will read all RBBS-PC MESSAGES files and all FIDO style  message
  1020.     subdirectories listed in the AREAS.BBS file.  All messages  are  processed
  1021.     and written to the the MAIL directory.  An AREA: tag  and,  if  needed  an
  1022.     ORIGIN: tag, will be added to the messagetext and the SEEN-BY: lines  will
  1023.     be appropriately added or updated.  A copy of the message will be sent  to
  1024.     all nodes listed in the send-to list for the AREA: the message is  in,  IF
  1025.     these nodes have not already received a  copy  of  this  specific  message
  1026.     (i.e.  the node was not in the SEEN-BY: tag).   Messages  that  have  been
  1027.     processed will be marked as such. 
  1028.  
  1029.     If a message contains NOECHO (just one word, in UPPER case) as  the  first
  1030.     line of the message text, RBBSMail will NOT send that message out  on  the
  1031.     network.  So, if there's anything to be said in  a  conference  that  only
  1032.     concerns users on YOUR system, put NOECHO as first line of the message and
  1033.     that message will not be sent to other systems.  Inform your  users  about
  1034.     this feature!
  1035.     RBBS-PC allows users to leave comments to sysop in conferences,  which  is
  1036.     not such a good idea anyway.  Those comments may contain information  that
  1037.     is  nobody  else's  business  but  the  sysop's.   Comments  to  Sysop  in
  1038.     conferences will not be sent out on the network. 
  1039.  
  1040.     Switch -AKA:# (where # is a number from 1....10) tells RBBSMail to put '#'
  1041.     of our AKA addresses in the SEEN-BY: lines.  Addresses  are  counted  from
  1042.     top to bottom in your RBBSMAIL.CFG file.  The first  address  is  used  as
  1043.     your  primary  address,  subsequent  ADDRESS  verbs  are  treated  as  AKA
  1044.     addresses.  RBBSMail uses no AKA addresses by default. 
  1045.     This way, you can have 10 AKA addresses that RBBSMail will  recognize  for
  1046.     incoming mail, and have only 1 or 2 of your AKAs listed in outgoing mail. 
  1047.  
  1048.     Note: This switch is ignored for point operation. 
  1049.  
  1050.     The -C: switch allows you to use a different filename for RBBSMAIL.CFG. 
  1051.     By explicitly giving a different filename for AREAS.BBS (-F: switch),  you
  1052.     can use an alternate filename for AREAS.BBS. 
  1053.  
  1054.     Switch -M:# (max: number) This tells RBBSMail after how many  messages  it
  1055.     should shell out to the  mail  packing  program  listed  in  RBBSMAIL.CFG.
  1056.     Every time # of  outgoing  messages  is  reached,  this  PACK  program  is
  1057.  
  1058.  
  1059.     Running RBBSMail                                                        16
  1060.  
  1061.  
  1062.  
  1063.     
  1064.  
  1065.  
  1066.     called.  By having the mail packer pack up the mail that has been exported
  1067.     up to that moment, you will generate  small  outgoing  mailbundles.   Some
  1068.     other echomail processors, like ConfMail, work more effectively with small
  1069.     mailbundles.  '#' can be any number between 1 and 32676. 
  1070.  
  1071.     Switch -O tells RBBSMail to store outgoing mail as  .OUT  bundles  in  the
  1072.     HOLD directory, instead  of  regular  FIDO  style  messages  in  the  MAIL
  1073.     directory.  This saves a step in packing up outgoing mail.  You  can  only
  1074.     use this switch with BinkleyTerm/oMMM or Dutchie/Packer. 
  1075.  
  1076.     If you use -OZ in stead of  -O,  and  you  have  Binkley  and  oMMM  v1.30
  1077.     properly configured for full ZONE support, RBBSMail with put outgoing mail
  1078.     for other zones in the right 'discrete' outbound directories.  Please  see
  1079.     the Binkley and oMMM v1.30 documentation how  to  set  up  the  full  ZONE
  1080.     support.  When using the -OZ switch, be sure to  have  FULL  ZONE:NET/NODE
  1081.     addresses in your AREAS.BBS file, otherwise RBBSMail will assume all  mail
  1082.     is for nodes in your own zone.  In this case, you also may leave the  ZONE
  1083.     addressing out of the 'send-to' lists in your AREAS.BBS file. 
  1084.  
  1085.     If you use AutoEcho, AreaFix or another automatic maintenance utility that
  1086.     allows other systems to change your AREAS.BBS file without  your  personal
  1087.     intervention, you may wish to use the -R  (Rescan)  switch.   This  forces
  1088.     RBBSMail to treat ALL messages in ALL conferences as new messages.  With a
  1089.     suitable batch file you can use the  errorlevel  returned  by  AreaFix  to
  1090.     rescan all your message areas.  This way, a system signing  up  to  get  a
  1091.     certain Echomail area from you will get the whole message base  the  first
  1092.     time RBBSMail SCAN runs after the other party signed up. 
  1093.  
  1094.     Note: This switch makes RBBSMail rather slow, so you may want  to  set  up
  1095.     your AutoEcho or AreaFix BATchfiles in such fashion that you do  a  RESCAN
  1096.     only when your AREAS.BBS has been refreshed. 
  1097.  
  1098.     During  the  SCAN  process,  RBBSMail  will   put   an   MSGID:   (Message
  1099.     Identification) tag at the top of all outgoing messages.  The  MSGID:  tag
  1100.     is a unique message identifier in the format MSGID: Z:N/N/P yyyyyyyy
  1101.  
  1102.       where:
  1103.       Z:N/N.P is your full Zone:Net/Node.Point address
  1104.       yyyyyyyy = a DOS style date&time marker.
  1105.  
  1106.     The datestamp plus the 16 bit CRC over the Sender, Addressee  and  Subject
  1107.     fields of the message are used to generate an identiefier that can be used
  1108.     to check for duplicate messages.  The identiefier, commonly known  as  the
  1109.     EID (Echo ID) is written to a file named xxxx.EID (where xxxx is the  name
  1110.     of the current conference).  This is a wrap around file, holding the  Echo
  1111.     Identifiers of the last 1364 incoming and outgoing echo messages for  each
  1112.     area. 
  1113.  
  1114.  
  1115.     3.3  TOSS mode
  1116.  
  1117.  
  1118.     This is the command line to invoke the TOSS mode:
  1119.  
  1120.  
  1121.  
  1122.     Running RBBSMail                                                        17
  1123.  
  1124.  
  1125.  
  1126.     
  1127.  
  1128.  
  1129.       RBBSMail TOSS -C:cfgfile -F:areas.bbs file -D -KU -L
  1130.                     -MD|ID -N -S -U -X
  1131.  
  1132.  
  1133.     Note: You can use either '-' or '/' as command delimiter. 
  1134.     The TOSS function will look in the MAIL directory for  incoming  Echomail.
  1135.     All messages addressed to your NET/NODE will be processed  to  either  the
  1136.     appropriate  RBBS-PC  conference  or  the  proper   FIDO   style   message
  1137.     subdirectory that is listed in AREAS.BBS for the AREA:tag in the  incoming
  1138.     FIDONET messages.  If there is no RBBS-PC conference file or FIDO  message
  1139.     subdirectory related to the AREA:label, the message is ignored.   You  can
  1140.     select to have it killed by using the -KU (Kill Unknown) switch. 
  1141.     During TOSS, RBBSMail  will  look  for  a  USERS  file  belonging  to  the
  1142.     conference it writes any message to.  This USERS file is scanned  for  the
  1143.     name the message is addressed  to.   If  the  name  is  found,  the  'mail
  1144.     waiting' bit for this user will be flipped ON.  If you use  the  new  mail
  1145.     notification or the [V]iew conferences feature of RBBS-PC (i.e.  you  have
  1146.     a CONFMAIL.DEF type file), users can quickly check if  there  is  any  new
  1147.     mail  in  the  conferences  without  having  to  access  each   conference
  1148.     separately. 
  1149.  
  1150.     Note: USERS file update only works for RBBS-PC  MESSAGES  files,  not  for
  1151.     FIDO style message subdirectories. 
  1152.     In the above examples, if a message is written to  the  TENNIS  conference
  1153.     (file TENNISM.DEF) RBBSMail will look for the name of the addressee in the
  1154.     file TENNISU.DEF.  The relation  MESSAGE<-->USERS  file  is  the  standard
  1155.     RBBS-PC method, i.e.   MESSAGES  file  xxxxM.DEF  relates  to  USERS  file
  1156.     xxxxU.DEF.  No fancy stuff allowed here, except that  the  .DEF  extension
  1157.     can be anything, as long as it is the same for both files.  For  instance,
  1158.     if you want to have the TENNIS conference as subboard and want to use  odd
  1159.     names for the  files,  TENNISM.AAA  and  TENNISU.AAA  or  TENNISM.123  and
  1160.     TENNISU.123 are legal names for RBBSMail to use.  In fact,  RBBSMail  only
  1161.     cares about the 'M' and 'U' in the names of the message and USERS files. 
  1162.  
  1163.     The -C: switch allows you to use a different filename for RBBSMAIL.CFG. 
  1164.     By explicitly giving a different filename for AREAS.BBS (-F: switch),  you
  1165.     can use an alternate filename for AREAS.BBS.  Be careful when you  process
  1166.     incoming mail with the -C: or -F: switch.  RBBSMail  will  only  recognize
  1167.     the AREA: tags listed in your alternate AREAS.BBS file, and the  setup  in
  1168.     your alternate RBBSMAIL.CFG file.  Any message with an AREA: tag  that  is
  1169.     not listed in your AREAS.BBS will be considered a bad_msg.  With the right
  1170.     (or wrong) choice of switches, RBBSMail will  kill  bad  msgs  immediately
  1171.     (See -KU switch).  To  process  incoming  Echomail,  best  is  to  use  an
  1172.     AREAS.BBS file that lists ALL Echomail areas you carry. 
  1173.  
  1174.     Switch -D (Direct)  will  put  messages  without  an  AREA:  tag  in  your
  1175.     AREA:GENERAL  MESSAGES  file.   Per  default,  RBBSMail  ignores  messages
  1176.     without an AREA: tag and leaves them sitting in the MAIL subdirectory. 
  1177.  
  1178.     Switch -KU (Kill Unknown) will let RBBSMail kill all messages  that  could
  1179.     not be put in  a  proper  conference.   Per  default,  all  messages  with
  1180.     unmatching AREA: tags will be left  sitting  in  your  MAIL  subdirectory.
  1181.     This way, you can use other Echomail programs to process these messages to
  1182.     other types of message bases like Opus, QuickBBS, TBBS or  whatever  other
  1183.  
  1184.  
  1185.     Running RBBSMail                                                        18
  1186.  
  1187.  
  1188.  
  1189.     
  1190.  
  1191.  
  1192.     system you run next to RBBS-PC. 
  1193.  
  1194.     Messages addressed to net/node numbers other than your net/node  number(s)
  1195.     are ignored and left in the MAIL directory. 
  1196.  
  1197.     Switch -L tells RBBSMail to log activities and  statistics  in  a  logfile
  1198.     named RBBSMail.LOG. 
  1199.  
  1200.     -MD tells RBBSMail not to kill duplicate message right away, but  to  move
  1201.     them to the DUPS directory.  You may then inspect the duplicates  manually
  1202.     with a suitable mail-editor (Dutched or MSGED).   RBBSMail  calculates  an
  1203.     Echo Identifier (EID) for each incoming message and checks it against  the
  1204.     contents of the corresponding xxxx.EID files.  If a given  EID  is  found,
  1205.     then a duplicate message is assumed and the message is  either  killed  or
  1206.     moved to the DUPS directory.  If the EID of an  incoming  message  is  not
  1207.     found, it will be added to the proper xxxx.EID, so possible duplicates  of
  1208.     that message can be recognized in the future. 
  1209.     For  FIDO  style  message  subdirectories,  a  file  named  EID   in   the
  1210.     subdirectory holds the EIDs. 
  1211.  
  1212.     Switch -ID tells RBBSMail not  to  check  for  duplicate  messages  during
  1213.     TOSS.  This makes RBBSMail slightly faster because it doesn't have to read
  1214.     and write the EID files for each separate area. 
  1215.     You can kill duplicate messages later by  using  the  -Killdup  switch  in
  1216.     MAINT mode. 
  1217.  
  1218.     Normally, when RBBSMail tosses a message into an RBBS-PC MESSAGES file, it
  1219.     will also update  the  mail  waiting  status  for  the  addressse  of  the
  1220.     message.  Switch -N tells RBBSMail to skip the USERS file search.  This is
  1221.     especially useful when you run a point setup (only one user reading  *all*
  1222.     the mail) or when you have disabled the "Check conferences for  Mail"  and
  1223.     "View Conferences" command in  your  system  (i.e.   you  do  not  have  a
  1224.     CONFMAIL.DEF file).  Switch -N makes  RBBSMail  slightly  faster  on  TOSS
  1225.     operations. 
  1226.     The -MD and -ID switches are mutually exclusive. 
  1227.  
  1228.     The -S switch tells RBBSMail that your node is a static system at the  end
  1229.     of a leg in the network (Cul-de-Sac), i.e.  your Echomail conferences  are
  1230.     only exchanged with ONE single other node.  If -S is used on a  TOSS  run,
  1231.     RBBSMail will not attempt to process messages that were received for other
  1232.     systems during subsequent SCAN runs. 
  1233.     Use this switch ONLY if you exchange all your  Echomail  conferences  with
  1234.     ONE single system.  This means that you do not feed  any  single  Echomail
  1235.     conference to more than one system and that you do not service points. 
  1236.     The exchange can be with a different system for any conference,  but  only
  1237.     one single system per separate conference. 
  1238.  
  1239.     Note: The -S switch is ignored for FIDO style message subdirectories. 
  1240.  
  1241.     Switch -X tells RBBSMail not to TOSS messages  from  the  MAIL  directory.
  1242.     RBBSMAIL unpacks incoming mailbundles and archived mailbundles.   Messages
  1243.     that cannot be tossed into a RBBS-PC MESSAGES file will be stored  in  the
  1244.     MAIL directory of your system.  It is not always useful to  process  these
  1245.     messages again and again.  However, if a MESSAGES file fills up,  RBBSMail
  1246.  
  1247.  
  1248.     Running RBBSMail                                                        19
  1249.  
  1250.  
  1251.  
  1252.     
  1253.  
  1254.  
  1255.     will write the messages for that area in the MAIL directory, too.  If  you
  1256.     do not process these messages automatically but do so at a later  time  by
  1257.     hand, it may well be that other mailbundles have been  succesfully  tossed
  1258.     in the mean time.  This  will  mess  up  the  date-order  in  the  RBBS-PC
  1259.     MESSAGES files. 
  1260.  
  1261.     While tossing messages, RBBSMail does a number of checks.  It keeps  track
  1262.     of the number of messages and the available space in the RBBS-PC  MESSAGES
  1263.     files.  This is to ensure your messages files will not be corrupted.   All
  1264.     these checks take up considerable time and people  have  complained  about
  1265.     this. 
  1266.     Switch -U (the UNSAFE option!) will skip the checking  and  RBBSMail  will
  1267.     TOSS slighly faster. 
  1268.     However!! This option can only  be  used  when  you  are  using  "elastic"
  1269.     MESSAGES files (i.e.  MESSAGES files that grow in size as new messages are
  1270.     added) and you have set the  maximum  number  of  messages  for  all  your
  1271.     MESSAGES files to 999.  If the maximum number of messages  of  a  file  is
  1272.     less then 999, RBBSMail will disable the UNSAFE option for that file.  And
  1273.     even then.....  In case your MESSAGES file fills up, RBBS-PC will blow  up
  1274.     in your face reporting a negative number  of  available  message  records.
  1275.     Your MESSAGE file may be corrupted and you owe it all to yourself. 
  1276.  
  1277.     To make it absolutely clear: The -U switch poses  a  potential  danger  to
  1278.     your MESSAGES files and it should not be used by the faint of heart.   You
  1279.     accept the sole responsibility for using it!
  1280.  
  1281.     Note: The -U switch is ignored for FIDO style message subdirectories. 
  1282.  
  1283.  
  1284.   │ 3.4  MAINT mode
  1285.  
  1286.  
  1287.   │ This is the command line to invoke the MAINT mode:
  1288.  
  1289.   │   RBBSMail MAINT:MESSAGES_FILE -age:# -K -L -R -T:# -usr:USER_FILE
  1290.   │    or
  1291.   │   RBBSMail MAINT:MESSAGES_SUBDIR -age:# -K - L -R
  1292.   │    or
  1293.   │   RBBSMail MAINT:@response_file - L
  1294.  
  1295.   │ RBBSMAIL will perform maintenance on the RBBS-PC  or  on  the  FIDO  style
  1296.   │ message  subdirectory.   Maintenance  on  RBBS-PC  MESSAGES   files   will
  1297.   │ physically remove all "inactive" messages, thus freeing up space  for  new
  1298.   │ messages. 
  1299.  
  1300.   │ Switch -AGE:# will tell RBBSMail not only to remove killed  messages,  but
  1301.   │ to also remove all message that are older than  the  specified  number  of
  1302.   │ days.  # nust be specified as an integer number between 1 and 32767. 
  1303.  
  1304.   │ Switch -R (renum) will also renumber the messages in the RBBS-PC  MESSAGES
  1305.   │ file or FIDO subdirectory, starting at Msg #1.  When  renumbering  RBBS-PC
  1306.   │ MESSAGES files, you may also specify a USERS_FILE.  All Last Message  Read
  1307.   │ pointers for each individual user will be adjusted accordingly. 
  1308.   │ Switch -T: (Treshold), followed  by  a  number,  indicates  that  renumber
  1309.  
  1310.  
  1311.     Running RBBSMail                                                        20
  1312.  
  1313.  
  1314.  
  1315.     
  1316.  
  1317.  
  1318.   │ should be performed only when the highest message number in  the  file  is
  1319.   │ above the treshold value. 
  1320.  
  1321.   │ Note: User file renumber and Treshold are not  supported  for  FIDO  style
  1322.   │ message subdirectories.  The LASTREAD file, used by SEADog  and  MsgEd  to
  1323.   │ keep track of the last  message  read  by  the  sysop,  will  be  properly
  1324.   │ adjusted. 
  1325.  
  1326.   │ Switch -K (Killdup) will scan the MESSAGES  file  or  FIDO  style  message
  1327.   │ subdirectory for duplicate messages.  This is especially  useful  if  your
  1328.   │ xxxx.EID files were damaged  or  erased  and  duplicate  messages  slipped
  1329.   │ through TOSS mode.  Also, If you do not check for duplicates  during  TOSS
  1330.   │ (see -ID switch on  TOSS),  you  can  kill  duplicates  later  during  the
  1331.   │ maintenance run. 
  1332.   │ In case you pack and renumber your  MESSAGES  files  every  night,  it  is
  1333.   │ advised not to check for duplicates  while  TOSSing  (i.e.   use  the  -ID
  1334.   │ switch),  and  to  run  MAINT  with  -Killdup  after  processing  received
  1335.   │ Echomail. 
  1336.  
  1337.   │ Switch -L will write the activities to the log file. 
  1338.  
  1339.   │ The above options may be combined in a number of ways.  Some examples:
  1340.  
  1341.   │   RBBSMail MAINT:C:\BINK\SYSOPS\ -R
  1342.  
  1343.   │ renumbers  the  messages  in   the   FIDO   style   message   subdirectory
  1344.   │ C&GML\BINK\SYSOPS\. 
  1345.  
  1346.   │ Note:  The  trailing  backslash  is  mandatory  for  RBBSMail  to  make  a
  1347.   │ destinction  between  RBBS-PC  MESSAGES  files  and  FIDO  style   message
  1348.   │ subdirectories. 
  1349.  
  1350.   │   RBBSMail MAINT:TENNISM.DEF -AGE:30
  1351.  
  1352.   │ removes all killed messages and all messages older than 30 days  from  the
  1353.   │ file TENNISM.DEF. 
  1354.  
  1355.   │   RBBSMail MAINT:TENNISM.DEF -RENUM
  1356.  
  1357.   │ removes all killed messages from the file TENNISM.DEF  and  renumbers  all
  1358.   │ messages in sequential order. 
  1359.  
  1360.   │   RBBSMail MAINT:TENNISM.DEF -AGE:30 -KILLDUP -RENUM -USR:TENNISU.DEF
  1361.  
  1362.   │ does it all in one (FAST!) sweep: All killed messages, all messages  older
  1363.   │ than 30 days and all duplicate messages are removed from TENNISM.DEF,  the
  1364.   │ messages are renumbered sequentially starting at 1 and  the  Last  Message
  1365.   │ Read pointers in the USERS file TENNISU.DEF are updated for all users. 
  1366.  
  1367.   │ For maintenance, RBBSMail accomodates the use of a  response  file.   This
  1368.   │ response file holds the names of RBBS-PC messages  files  and  FIDO  style
  1369.   │ messages subdirectories where maintenance is to be performed on.  To start
  1370.   │ maintenance mode with a response file, call RBBSMail like this:
  1371.  
  1372.  
  1373.  
  1374.     Running RBBSMail                                                        21
  1375.  
  1376.  
  1377.  
  1378.     
  1379.  
  1380.  
  1381.   │   RBBSMAil [-L] MAINT: @maint.ctl
  1382.  
  1383.   │ The file MAINT.CTL could, for instance, contain:
  1384.  
  1385.   │   C:\RBBS\TENNISM.DEF -AGE:30 -R -USR:C:\RBBS\TENNISU.DEF
  1386.   │   C:\BINK\SYSOPS\ -AGE:10 -R
  1387.  
  1388.   │ This will renumber the TENNIS conference and it's USERS file and kill  all
  1389.   │ messages older than 30 days.  The SYSOPS conference, a FIDO style  message
  1390.   │ subdir, will be renumbered and all messages older than  10  days  will  be
  1391.   │ deleted. 
  1392.   │ Switch -L will optionally write the activities to the logfile. 
  1393.  
  1394.   │ Note: The maintenace facilities  for  FIDO  style  message  usbdirectories
  1395.   │ provided by RBBSMail are only the bare essentials.   The  programs,  RENUM
  1396.   │ and  REPLYLINK  offer  more  functionality  for   doing   this   type   of
  1397.   │ mainetnance. 
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.     Running RBBSMail                                                        22
  1438.  
  1439.  
  1440.  
  1441.     
  1442.  
  1443.  
  1444.     4. A word on RBBS-PC MESSAGES files
  1445.  
  1446.  
  1447.     4.1  Filesizes
  1448.  
  1449.  
  1450.     When you installed RBBS-PC, it required you to tell it what the  size  (in
  1451.     128 byte records) of your MESSAGES files should be,  how  many  lines  per
  1452.     message you allow and what the maximum amount  of  active  messages  in  a
  1453.     particular MESSAGE file should be.  RBBSMail has its own ideas  about  the
  1454.     size of a message, so you should take a few precautions. 
  1455.     If you configure RBBS-PC to use MESSAGES files that grow as  messages  are
  1456.     added, and you set the maximum amount of messages to 999, you  don't  need
  1457.     to bother  with  sizes  of  MESSAGES  files.   Just  include  the  ELASTIC
  1458.     configuration option in RBBSMAIL.CFG and RBBSMail will manage the size  of
  1459.     the MESSAGES files for you.  RBBSMail will respect the maximum  number  of
  1460.     messages you configured for any MESSAGES file. 
  1461.  
  1462.     Note: These checks can be omitted with the -U (unsafe) switch. 
  1463.     RBBSMail will change the size of a message, because it has  to  modify  or
  1464.     add the SEEN-BY: line(s) and possibly add an ORIGIN:  line.   In  general,
  1465.     make the size of your conference files about 15% to 20% larger than needed
  1466.     for the maximum number of messages you allow if you do not use the elastic
  1467.     MESSAGES files. 
  1468.  
  1469.     However, RBBSMail will always check the number  of  free  records  in  any
  1470.     MESSAGES file before it starts processing that  file.   If  there  is  not
  1471.     sufficient room left to process the newly entered message  in  a  MESSAGES
  1472.     file, RBBSMail will not process the file. 
  1473.  
  1474.     If, for some reason, the MESSAGES file is full before the SCAN process  is
  1475.     completed, the MESSAGES file will be expanded to ensure that  no  messages
  1476.     are lost. 
  1477.     A warning about the expansion will be written to  the  RBBSMail.LOG  file.
  1478.     Other than in the above  situation,  RBBSMail  will  respect  the  maximum
  1479.     number of messages allowed in any MESSAGES file and the size of the  file,
  1480.     but NOT the size of a single message. 
  1481.  
  1482.     In any case, RBBSMail  will  ALWAYS  increase  the  size  of  any  message
  1483.     originating from your system by AT LEAST 5 lines (2 or 3  records  of  128
  1484.     bytes) by adding the MSGID: tag, Tearline, Origin line, SEEN-BY: line  and
  1485.     PATH: line to these messages. 
  1486.  
  1487.     The formula used by RBBSMail to  calculate  the  number  of  free  records
  1488.     needed to process a MESSAGES file is:
  1489.  
  1490.       free_records > new_msgs * 4
  1491.  
  1492.     Example: If you  have  an  average  of  25  new  messages  per  day  in  a
  1493.     conference, you must have 25*4  =  100  FREE  records  available  in  that
  1494.     MESSAGE file when RBBSMail SCAN starts. 
  1495.     If you use RBBS-PC's CONFIG to build a MESSAGES file of 1024 records,  and
  1496.     set a maximum of 25 lines per message, there will be room  for  about  205
  1497.     messages.  That is about 5 records per message.  So, you will have to  set
  1498.  
  1499.  
  1500.     A word on RBBS-PC MESSAGES files                                        23
  1501.  
  1502.  
  1503.  
  1504.     
  1505.  
  1506.  
  1507.     the maximum number of messages down to 184,  leaving  105  records  (about
  1508.     10%) that will never be used by RBBS-PC. 
  1509.  
  1510.     As there are no restrictions to  the  size  of  FIDONET  messages,  it  is
  1511.     possible that you receive mail with more lines per message than  you  have
  1512.     pre-set in RBBS-PC's CONFIG program. 
  1513.  
  1514.     You should periodically review the behaviour of your MESSAGES  files.   If
  1515.     you get the EXPANDED message during SCAN or a MESSAGES  file  FULL  during
  1516.     TOSS, it is time to make your MESSAGES files larger  and/or  increase  the
  1517.     percentage of free records.  Kim Wells' MU-PURGE program shows  statistics
  1518.     about the amount of used and free space in your MESSAGES files. 
  1519.  
  1520.     Sometimes RBBSMail just hangs up in the middle of  a  SCAN  or  TOSS  run.
  1521.     This is usually caused by a broken link in the MESSAGES file.  A  possible
  1522.     reason for having your MESSAGES files messed up is that MU-PURGE choked on
  1523.     a message that was too big to process.  If you run MU-PURGE on a  MESSAGES
  1524.     file with a lot of *big* messages, MU-PURGE  will  sometimes  run  out  of
  1525.     memory and abort, leaving a broken chain in the MESSAGES file. 
  1526.  
  1527.     It is therefore HIGHLY advised to set the SIZE parameter  in  RBBSMAIL.CFG
  1528.     to a value of 12000 or less. 
  1529.  
  1530.     If the above happens, the most elegant way to recover is:
  1531.  
  1532.         - Use RBBS-PC's CONFIG program to repair the broken MESSAGES file. 
  1533.         - Use RBBS-PC's CONFIG program to pack the MESSAGES file. 
  1534.         - Start RBBS-PC and kill the lowest message  number  of  the  MESSAGES
  1535.         file you just repaired. 
  1536.         - Decrease the value of the SIZE parameter in RBBSMAIL.CFG. 
  1537.  
  1538.     As an alternative to MU-PURGE's message packing, RBBSMail now  offers  the
  1539.     PACK mode for messages file maintenance. 
  1540.  
  1541.  
  1542.     4.2  Filenames for CONFERENCES
  1543.  
  1544.  
  1545.     Let's take the TENNIS conference from the  above  examples.   You  have  a
  1546.     TENNISM.DEF file that holds all the messages and a TENNISU.DEF  file  that
  1547.     holds all users of the TENNIS conference.  If you create a file TENNIS.ORG
  1548.     in the same directory your  TENNISM.DEF  and  TENNISU.DEF  files  are  in,
  1549.     RBBSMail will take the FIRST line from this file and use it as the text in
  1550.     your * Origin line. 
  1551.     So,  for  all  conferences  or  subboards  on  your  system,  the   naming
  1552.     conventions should be:
  1553.  
  1554.     xxxxM.def the Messages file of conference with name 'xxxx'
  1555.     xxxxU.def the Users file of conference with name 'xxxx'
  1556.     xxxx.EID  the file containing the EIDs of the last 1364 messages processed
  1557.               for this conference.   You  shouldn't  bother  with  this  file,
  1558.               RBBSMail handles it for you. 
  1559.     xxxx.ORG  the file  containing  the  text  of  the  Origin  line  for  the
  1560.               conference with filename 'xxxxM.DEF'
  1561.  
  1562.  
  1563.     A word on RBBS-PC MESSAGES files                                        24
  1564.  
  1565.  
  1566.  
  1567.     
  1568.  
  1569.  
  1570.  
  1571.     For FIDO style message subdirectorie, a file named EID in the subdirectory
  1572.     holds the EIDs. 
  1573.  
  1574.  
  1575.     4.3  Filenames for SUBBOARDS
  1576.  
  1577.  
  1578.     RBBS-PC allows any valid DOS filename  for  MESSAGE  and  USERS  files  in
  1579.     subboards.  By not using the standard RBBS-PC xxxxM.DEF naming convention,
  1580.     MESSAGES files are not accessible by the [J]oin conference command,  which
  1581.     is exactly what you want for a subboard. 
  1582.     This poses a bit of a problem for RBBSMail, for it has no way of  figuring
  1583.     out the names of MESSAGE and  USERS  files  in  subboards,  execept  maybe
  1584.     reading the RBBSxPC.DEF files for each conference  and/or  subboard.   And
  1585.     that would be very slow. 
  1586.  
  1587.     Therefore, RBBSMail uses the following convention for  MESSAGE  and  USERS
  1588.     files that are not named according to the standard RBBS-PC  xxxxM.DEF  and
  1589.     xxxxU.DEF method:
  1590.  
  1591.     ABCXYZ    the MESSAGES file of a subboard (NO extension!)
  1592.     ABCXYZ.USRthe USERS file of the subboard with ABCXYZ as MESSAGE file (.USR
  1593.               extension is mandatory!)
  1594.     ABCXYZ.EIDthe file containing the EIDs of the last 1364 messages processed
  1595.               in this  conference.   You  shouldn't  bother  with  this  file,
  1596.               RBBSMail handles it for you. 
  1597.     ABCXYZ.ORGthe file containing the  text  for  the  Origin  line  for  this
  1598.               subboard. 
  1599.  
  1600.     In short:
  1601.     If your RBBS-PC MESSAGE and USERS files are named in the form of xxxxM.DEF
  1602.     with an accompanying xxxxU.DEF file, RBBSMail will strip  off  the  M.DEF,
  1603.     and ONLY the significant part of the MESSAGES file's filename  (i.e.   the
  1604.     conference name) will be  used  to  identify  the  xxxx.ORG  and  xxxx.EID
  1605.     files. 
  1606.     If your RBBS-PC MESSAGE and USERS files (for subboards) only consist of  a
  1607.     filename with no extension, the whole name of the files will  be  used  to
  1608.     identify xxxx.ORG and xxxx.EID files. 
  1609.  
  1610.  
  1611.   │ 4.4  Filenames for FIDO style subdirs
  1612.  
  1613.  
  1614.   │ In a FIDO style message subirectory, all messages are  in  separate  files
  1615.   │ with the extension '.MSG" (i.e.  message 1 will be 1.MSG).  The filenaming
  1616.   │ convention for FIDO style message bases differs somewhat  from  the  above
  1617.   │ method of naming files for RBBS-PC conferences and subboards. 
  1618.  
  1619.   │ To have a separate text for the origin  lines  in  a  FIDO  style  message
  1620.   │ subirectory, simply put a file with the name ORIGIN (no extension) in that
  1621.   │ particular subdirectory.  This is the equivalent  of  the  xxxx.ORG  files
  1622.   │ mentioned avbove. 
  1623.  
  1624.  
  1625.  
  1626.     A word on RBBS-PC MESSAGES files                                        25
  1627.  
  1628.  
  1629.  
  1630.     
  1631.  
  1632.  
  1633.   │ The EIDs of the last 1365 messages are stored in  the  subdirectory  in  a
  1634.   │ file named EID (no extension).  It is the equivalent of the xxxx.EID files
  1635.   │ mentioned above. 
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.     A word on RBBS-PC MESSAGES files                                        26
  1690.  
  1691.  
  1692.  
  1693.     
  1694.  
  1695.  
  1696.     5. How to set up your mail
  1697.  
  1698.  
  1699.     5.1  What you need
  1700.  
  1701.  
  1702.     To get your mail in and out on the FIDONET, you need  a  number  of  other
  1703.     programs and files.  (Assuming you already have RBBS-PC running):
  1704.  
  1705.     ■   Frontend mailer (BinkleyTerm, Dutchie or d'Bridge)
  1706.     ■   oMMM, mOOO or Packer, to pack up outgoing mailbundles
  1707.     ■   ARCA and ARCE or PKARC and PKXARC
  1708.     ■   If you  don't  want  RBBSMail  to  unpack  incoming  mailbundles,  use
  1709.         Confmail, QM  or  whatever  appropriate  program  to  unpack  incoming
  1710.         mailbundles. 
  1711.     ■   A recent nodelist
  1712.     ■   PARSELST, a program to compile and update your nodelist
  1713.     ■   A mail-editor (Dutched or MSGED) to inspect incoming/outgoing mail  is
  1714.         strongly suggested.  It will be a great help getting started. 
  1715.  
  1716.     First, you need to set up the frontend mailer  and  the  schedules.   Your
  1717.     local or regional HOST or HUB has to supply the times when you should call
  1718.     him to deliver and pick up your mail.  There is an extensive chapter about
  1719.     setting up schedules (or events) and routing in the documentation of  your
  1720.     frontend mailer. 
  1721.     If you want to have control over your schedules  from  within  your  batch
  1722.     files (i.e.  outside the scheduler of your mail frontend), you may want to
  1723.     look at the program WDATIME that is included  in  this  package.   WDATIME
  1724.     enables you to test Month, Date, Time and Day of the Week from within your
  1725.     batch files. 
  1726.  
  1727.     It is STRONGLY recommended to make arrangements with your HOST or  HUB  to
  1728.     have him forward the weekly NODELIST or NODEDIFF files, so  your  nodelist
  1729.     will always be up to date.  See PARSELST.DOC how to set  up  an  automatic
  1730.     update of your nodelist. 
  1731.     If  your  HOST  or  HUB  carries  the  weekly  FIDO  newsletter  or  other
  1732.     newsletters of interest, ask him to forward it to you.  There is a lot  of
  1733.     useful information in some of these regular newsletters. 
  1734.  
  1735.     After you set up your frontend mailer and your schedules, you are ready to
  1736.     run. 
  1737.     Well, sort of.....  While setting up the events and the bulky  batch  file
  1738.     you need to run your system plus mailer, you should  also  stick  in  some
  1739.     lines containing RBBSMail SCAN and RBBSMail TOSS  at  the  proper  places.
  1740.     I'm afraid you are on your own on this, there is no  boilerplate  for  it.
  1741.     You should at least do a SCAN run shortly  BEFORE  your  main  mail  event
  1742.     (usually the National Mail Hour) and a TOSS run AFTER the NMH.  If you run
  1743.     mail outside the NMH, for  instance  to  exchange  mail  with  othe  local
  1744.     systems, you may do SCAN and TOSS as often  as  you  may  need  for  other
  1745.     events. 
  1746.     Again, you have to decide on this in agreement with whatever other systems
  1747.     you exchange mail with. 
  1748.  
  1749.  
  1750.  
  1751.  
  1752.     How to set up your mail                                                 27
  1753.  
  1754.  
  1755.  
  1756.     
  1757.  
  1758.  
  1759.     5.2  A quick overview
  1760.  
  1761.  
  1762.   │ 1.  Bring down all your RBBS-PC nodes. 
  1763.   │ 2.  Run MU-PURGE or RBBSMail MAINT on all your conferences. 
  1764.   │ 3.  Run RBBSMail SCAN to export new mail from your system. 
  1765.   │ 4.  Bring up all your RBBS-PC nodes,  except  for  the  one  that  handles
  1766.   │     mail. 
  1767.   │ 5.  Run your mailpacker (oMMM, MOOO  or  whatever)  with  the  appropriate
  1768.   │     schedules and routings (contact your  host  for  the  routing).   Your
  1769.   │     outgoing mail is now ready to be sent. 
  1770.   │ 6.  Have your frontend mailer call all other  systems  you  exchange  mail
  1771.   │     with, or sit and wait for them to call you. 
  1772.   │ 7.  Run RBBSMail TOSS to import the received Echomail.  You do not need to
  1773.   │     bring down all your RBBS nodes when  TOSSIng  mail.   If  you  service
  1774.   │     POINTS,  all  remapping  to  and  from  the  PRIVATENET  is  performed
  1775.   │     automatically  during  TOSS.   If  your  system  is  a  Zonegate,  all
  1776.   │     interzone mail, too, is handled during TOSS. 
  1777.   │     You may wish to use ConfMail to unpack all received mail if  you  have
  1778.   │     both FIDO style message subdirectories  and  RBBS-PC  MESSAGES  files.
  1779.   │     ConfMail can then process the mail for these subdirectories and  leave
  1780.   │     the mail for RBBSMail in the MAIL directory. 
  1781.   │ 8.  Bring up all your RBBS-PC nodes again. 
  1782.   │ 9.  You have now succesfully exchanged Echomail.  Congratulations!
  1783.  
  1784.  
  1785.     Note: If you have both FIDO/OPUS style messages  directories  AND  RBBS-PC
  1786.     MESSAGES files for your Echomail, you need TWO AREAS.BBS files if you want
  1787.     the FIDO style conferences  to  be  processed  by  another  program.   For
  1788.     instance, you need an AREAS.BBS for ConfMail to process mail  to/from  the
  1789.     FIDO style subdirectories and an AREAS.BBS for RBBSMail  to  process  mail
  1790.     to/from the RBBS-PC MESSAGES files.  The  two  files  may  have  different
  1791.     names or may be located in different subdirectories.  You can NOT use  the
  1792.     same AREAS.BBS file for both ConfMail and RBBSMail. 
  1793.  
  1794.  
  1795.     5.3  Enhanced setup
  1796.  
  1797.  
  1798.     With combinations of different RBBSMAIL.CFG, AREAS.BBS and xxxx.ORG  files
  1799.     you can do CRITMON.  That is  Creative  Renaming  In  The  Middle  Of  The
  1800.     Nigth.  You can appear to the net as  two  or  more  completely  different
  1801.     systems.  Or run as one system in several different  networks.   Or  both.
  1802.     Or send all your Echomail to  yourself  twice  every  night.   Or  receive
  1803.     Echomail as 123/1 and send the whole bunch back to  your  host  as  789/2,
  1804.     thus making a lot of "friends". 
  1805.  
  1806.     Don't rush to your keyboard to do CRITMON right away.  Remember,  Personal
  1807.     Computers can be  used  Personally,  programmed  Personally  and  you  can
  1808.     Personally screw the thing up beyond belief.  Like me, you are  likely  to
  1809.     do the latter..... 
  1810.  
  1811.     Sit down with a big sheet of paper, a pencil and a pencil  eraser.   Setup
  1812.     an overview of what you want your system to do and  where  you  send  mail
  1813.  
  1814.  
  1815.     How to set up your mail                                                 28
  1816.  
  1817.  
  1818.  
  1819.     
  1820.  
  1821.  
  1822.     to.  Figure out the setup of your config files  and  your  schedule(s)  of
  1823.     events.  Then, set up your system for ONE of  the  alternatives  and  test
  1824.     it.  With another sheet of paper, setup the other alternatives,  and  test
  1825.     them one by one.  In any case, don't change more than one thing at a  time
  1826.     in your setup.  FUBAR is the  word!  RBBSMail  will  (in  most  cases)  do
  1827.     faithfully what you want, even with the craziest setup.  If it doesn't  do
  1828.     what you want, (and even if it does) you have yourself to thank for it. 
  1829.  
  1830.  
  1831.     5.4  Zonegate Operation
  1832.  
  1833.  
  1834.     FIDONET is dived into geographical areas called ZONES.   North  and  South
  1835.     America are Zone 1, Europe and Africa are Zone 2, Asia and  Australia  are
  1836.     Zone 3, plus there are some countries with a separate zonenumber. 
  1837.     Netmail between zones should be sent to the the system that is  acting  as
  1838.     the zonegate for the zone your system is in.  For instance,  your  address
  1839.     is 2:512/10.0 and want to send a messages to someone  at  3:307/3.0.   You
  1840.     then address the message to the your zone's to the other  zone.   In  this
  1841.     case, the zonegate address is 2:2/3 (i.e.  the zonegate TO zone 3 IN  zone
  1842.     2).  Furthermore, you add
  1843.  
  1844.       ^AINTL 3:307/0 2:512/10
  1845.  
  1846.     (international) tag to the body of the message.  When the message  arrives
  1847.     at zonegate 2:2/3, it looks at the ^AINTL tag and will send the message to
  1848.     the Zone 3 zonegate at address 3&gml3/2.  The zonegate on the  other  side
  1849.     also looks at the ^AINTL tag and  will  forward  the  message  to  address
  1850.     3:307/0. 
  1851.  
  1852.     When your system is set up as zonegate for zone 3,  add  "ZONEGATE  3"  to
  1853.     RBBSMAIL.CFG.  Do NOT add your zonegate address  in  the  ADDRESS  phrase.
  1854.     Address  translation  for  zonegate  operation  is  handled  by   RBBSMail
  1855.     internally.  When a message addressed to 2/3 is received  on  your  system
  1856.     AND it has a ^AINTL  tag  addresses  to  Zone  3,  that  message  will  be
  1857.     forwarded to the zonegate in the other zone (i.e.  to 3:3/2). 
  1858.  
  1859.     All mail with a ^AINTL tag addressed to a zone that is not your  zone  and
  1860.     not addressed to the zone you are the zonegate for, will be  forwarded  to
  1861.     the proper zonegate in your own zone.  For instance, if you do NOT run the
  1862.     zonegate for zone 5 and a message addressed to zone 5 is received on  your
  1863.     system, that message will be forwarded to the Zone 5 gateway in  your  own
  1864.     zone (in this case, at address 2:2/5). 
  1865.  
  1866.     If your system is NOT a zonegate, all mail with  a  ^AINTL  tag  addressed
  1867.     outside your own zone will be routed to the proper zonegate in your zone. 
  1868.  
  1869.  
  1870.     5.5  Error determination
  1871.  
  1872.  
  1873.     Sometimes it looks as if you just can't get it right.   If  you  encounter
  1874.     problems with RBBSMail, step thru the following procedure to diagnose  the
  1875.     situation. 
  1876.  
  1877.  
  1878.     How to set up your mail                                                 29
  1879.  
  1880.  
  1881.  
  1882.     
  1883.  
  1884.  
  1885.     1.  RTFM. 
  1886.     2.  Check the configuration files for  typos,  incorrect  drive,  path  or
  1887.         filenames.  Check contents of AREAS.BBS.  Change if needed. 
  1888.     3.  RTFM again. 
  1889.     4.  Check the commandline for proper switches.  Change if needed. 
  1890.     5.  Relax, have a cup of coffee and let the situation soak in for a while
  1891.     6.  Run the program again. 
  1892.     7.  If the  symptoms  change,  repeat  the  above  steps  till  the  error
  1893.         'magically' disappears. 
  1894.     8.  If the above steps fail, erase RBBSMail.LOG. 
  1895.     9.  Run RBBSMail in the failing situation with -DEBUG as last argument  on
  1896.         the commandline. 
  1897.     10. Send me a CRASHmail message with the problem described and file-attach
  1898.         a copy of your setup files and the RBBSMail.LOG file that was  created
  1899.         during the above step.   Feel  free  to  include  any  other  relevant
  1900.         information, like type and version number of hardware and software you
  1901.         use, filesizes, AREAS.BBS, BINKLEY.CRG and such. 
  1902.     11. Poll my system after a few days to see if there's a reply for you.  If
  1903.         you have a real problem, and I'm not on  vacation,  there  will  be  a
  1904.         reply (and hopefully a fix) waiting. 
  1905.     12. If there's no reply and I'm not on vacation, RTFM and repeat the above
  1906.         steps. 
  1907.     13. Flames will never be dignified with an answer. 
  1908.  
  1909.  
  1910.     5.6  Other stuff
  1911.  
  1912.  
  1913.     I'm sure you will have a lot of questions about Echomail.  It is a strange
  1914.     sort of animal to RBBS-PC sysops.  But, don't fear! Echomail  can  be  fun
  1915.     and can be a great enhancement to your system.  If, at  first,  you  don't
  1916.     understand what Echomail is all about, talk to a local OPUS or FIDO  sysop
  1917.     or to the sysop of the host in your local  network.   Sysops  are  strange
  1918.     birds, but very helpful and usually eager to show you around.  The  moment
  1919.     you have your Echomail running you'll see the benefits of it. 
  1920.  
  1921.     If you decide to hook up your RBBS-PC system to the world of FIDONET,  you
  1922.     also  may  wish  to  take  part  in  several  RBBS-PC   related   Echomail
  1923.     conferences.  In the USA, contact your  local  host  system.   In  Europe,
  1924.     contact me by sending me a netmail message, and start polling for  mail  a
  1925.     few days later. 
  1926.  
  1927.     And there are several Echomail  conferences  about  the  frontend  mailers
  1928.     BINKLEY  (for  BinkleyTerm),  WINDMILL  (for  Dutchie)  and  DBRIDGE  (for
  1929.     d'Bridge, what else..).  If a local or regional  HOST  or  HUB  carries  a
  1930.     conference on the mail frontend you use,  make  arrangements  to  get  the
  1931.     echo.  It will be of great help to you. 
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.     How to set up your mail                                                 30
  1942.  
  1943.  
  1944.  
  1945.     
  1946.  
  1947.  
  1948.     6. The RBBSNet
  1949.  
  1950.  
  1951.     Several RBBS-PC sysops have started  a  RBBSNet,  separate  from  FIDONET.
  1952.     Currently, there are a bunch of FIDO  compatible  networks  in  operation:
  1953.     FIDONET, EggNet, The People's Net, AlterNet, TuboDatanet and GT-Net.   I'm
  1954.     part of both FIDONET and RBBSNet, and my system is  the  European  gateway
  1955.     for RBBSNet (node 8:998/1.0  in  the  RBBSNet).   For  more  info  on  the
  1956.     RBBSNet, Contact Rod Bowman of the PC-Spectrum RBBS in Alta  Loma,  CA  at
  1957.     (714) 945-2612.  Rod has put an enormous amount of work in setting up  the
  1958.     RBBSNet.  I sure hope it will all work out. 
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.     The RBBSNet                                                             31
  2005.  
  2006.  
  2007.  
  2008.     
  2009.  
  2010.  
  2011.     7. Future enhancements
  2012.  
  2013.  
  2014.     7.1  Planned for new releases
  2015.  
  2016.  
  2017.     In order of priority:
  2018.  
  2019.     1.  RBBS-PC USERS file maintenance. 
  2020.     2.  Combination of SCAN, MAINT and Renum in one sweep. 
  2021.     3.  Full NETmail capability, but this  is  waiting  for  some  changes  in
  2022.         RBBS-PC. 
  2023.     4.  Full filesharing support for RBBS-PC systems running  multiple  copies
  2024.         under DESQView, DoubleDos, Multilink, Alloy PCSlave,  IBM  Token  Ring
  2025.         Network (i.e.  NETBIOS),  10-Net,  Corvus  Omninet  and  Ochid  PCnet.
  2026.         (Suggestions, anyone???)
  2027.     5.  A version of RBBSMail that will fully run under OS/2.  I already  have
  2028.         one, but it is not yet a stable piece of software.  (Huh?? Is software
  2029.         ever stable??)
  2030.  
  2031.     If you have any comments, suggestions for enhancements or you  have  found
  2032.     something in RBBSMail that doesn't work the way it should,  feel  free  to
  2033.     contact me via Bamestra RBBS.  See the title page of this document for the
  2034.     node number and phonenumbers.  You may also leave a message in the RBBS-PC
  2035.     Echomail conference. 
  2036.  
  2037.  
  2038.     7.2  Comments & Suggestions
  2039.  
  2040.  
  2041.     If you have comments on the workings  of  RBBSMail,  suggestions  for  new
  2042.     features, improvements or bug reports, feel free to send a NETmail message
  2043.     to Sysop at FIDO 2:512/10.0 (RBBSNet 8:998/1.0) or a written letter to the
  2044.     postal address listed on the title page. 
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.     Future enhancements                                                     32
  2068.  
  2069.  
  2070.  
  2071.     
  2072.  
  2073.  
  2074.     Appendix A. Changes to RBBS-PC
  2075.  
  2076.  
  2077.     Add the patch below to RBBS-PC v17.1D and  the  'hidden'  lines  (prefixed
  2078.     with a 'Ctrl-A' or x'01' and the SEEN-BY: lines will be  suppressed  while
  2079.     reading Echomail messages.  There were many complaints about the redundant
  2080.     (from a user's point of view) info in echo mail.  This patch satisfies the
  2081.     complaints. 
  2082.  
  2083.       ' * UNCOMPRESS MESSAGE PRIOR TO DISPLAY
  2084.       ' * Changed to filter Echomail info by <JT> - for RBBS-PC 17.1D
  2085.       '
  2086.       9000 IF NOT JUST.
  2087.       SEARCHING THEN _
  2088.               CALL SKIPLINE (1) : _
  2089.               REMAIN$ = ""
  2090.            FOR X = 2 TO VAL(MID$(MESSAGE.RECORD$,117,4))
  2091.               J = 1
  2092.               GET 1
  2093.               IF JUST.SEARCHING THEN _
  2094.                  A$ = MESSAGE.RECORD$ : _
  2095.                  CALL ALLCAPS (A$) : _
  2096.                  HIGHLITE.POS = INSTR(A$,SEARCH.STRING$) : _
  2097.                  IF HIGHLITE.POS > 0 THEN _
  2098.                     HIGHLITE.REC = LOC(1) : _
  2099.                     X = 9999 : _
  2100.                     GOTO 9090 _
  2101.                  ELSE GOTO 9090
  2102.       9050    B = INSTR(J,MESSAGE.RECORD$,CHR$(227))
  2103.       9060    IF B = 0 THEN _
  2104.                  REMAIN$ = MID$(MESSAGE.RECORD$,J) : _
  2105.                  GOTO 9090
  2106.       9070    A$ = REMAIN$ + MID$(MESSAGE.RECORD$,J,B-J)
  2107.               REMAIN$ = ""
  2108.               IF HIGHLITE.REC = LOC(1) THEN _
  2109.                     HIGHLITE.REC = -1
  2110.       9085    J = B + 1
  2111.               IF MID$(A$,1,1) = CHR$(01) OR MID$(A$,1,9) = "SEEN-BY: " THEN _
  2112.                  GOTO 9050
  2113.               GOSUB 12979
  2114.               IF RET THEN _
  2115.                  RETURN
  2116.               CALL ASKMORE ("",TRUE,TRUE,MESSAGES.SELECTED.INDEX,FALSE)
  2117.               IF NO THEN _
  2118.                  GOTO 5160
  2119.               GOTO 9050
  2120.       9090 NEXT
  2121.            IF JUST.SEARCHING AND HIGHLITE.POS > 0 THEN _
  2122.               JUST.SEARCHING = FALSE : _
  2123.               GET 1,M(MESSAGE.DIM.INDEX,1) : _
  2124.               GOSUB 8000 : _
  2125.               GOTO 9000
  2126.            A$ = ""
  2127.            RETURN
  2128.  
  2129.  
  2130.     Appendix A. Changes to RBBS-PC                                          33
  2131.  
  2132.  
  2133.  
  2134.     
  2135.  
  2136.  
  2137.  
  2138.     This patch is based on RBBS-PC v17.1D,  vanilla  flavour.   Unfortunately,
  2139.     the patch will disable emphasizing within the message text, i.e.  if a hit
  2140.     is found while you 'search-and-read',  the  hit  will  NOT  be  emphasized
  2141.     within the message body. 
  2142.     For RBBS-PC v17.2A and later, this patch is not needed.   The  new  CONFIG
  2143.     program has an option to suppress lines in  messages  that  start  with  a
  2144.     sysop-definable string, which should be set to "SEEN-BY: ". 
  2145.  
  2146.     Furthermore, there is  a  conflict  between  RBBSMail's  way  of  flagging
  2147.     messages that are processed  and  "repair  message  file"  option  185  in
  2148.     RBBS-PC's CONFIG program.   RBBSMail  changes  the  ":"  (colon")  in  the
  2149.     datefield of the message  header  to  a  "."  (dot)  to  flag  a  message.
  2150.     CONFIG's option 185 will choke on this, because it uses that same  ":"  to
  2151.     scan for valid message headers. 
  2152.     This will result  in  mixed-up  message  numbering.   To  circumvent  this
  2153.     conflict, either do not use CONFIG option 185  (you  don't  normally  need
  2154.     that option), or remove the following line from linenumber 50580 of module
  2155.     CONFIG.BAS:
  2156.  
  2157.       AND MID$(MESSAGE.RECORD$,64,1) = ":" _
  2158.  
  2159.     This line appears TWICE in linenumber 50580. 
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.     Appendix A. Changes to RBBS-PC                                          34
  2194.  
  2195.  
  2196.  
  2197.     
  2198.  
  2199.  
  2200.     Appendix B. DBCS operation
  2201.  
  2202.  
  2203.     "Double Byte Character Set" is a way of representing the Chinese, Japanese
  2204.     and Korean pictorial characters.  A DBCS character consists of  two  bytes
  2205.     in the form:
  2206.  
  2207.       XXYY
  2208.  
  2209.       where XX can be a hex value from x'40' thru x'7E'
  2210.             YY can be a hex value from x'A1' thru x'FE'.
  2211.  
  2212.     DBCS poses a problem when translating strings to upper case.   Upper  case
  2213.     translation is done inside RBBS-PC and RBBSMail for user names  and  parts
  2214.     of the message text.  The normal method used for case translation of plain
  2215.     ASCII tekst messes up DBCS strings. 
  2216.     RBBSMail can be told to skip case translation by putting the  DBCS  phrase
  2217.     in RBBSMAIL.CFG and will thus not mess up DBCS text. 
  2218.  
  2219.     Another thing is  the  carriage  return  substitution  used  in  RBBS-PC's
  2220.     messages.  Normally, a carriage return is hex x'0D'.  RBBS-PC  uses  x'E3'
  2221.     internally, but that characters happens to be one half of a  set  of  DBCS
  2222.     characters.  To prevent messing  up  message  text,  RBBSMail  uses  x'93'
  2223.     (ASCII 147) as carriage  return  substitution  when  configured  for  DBCS
  2224.     operation. 
  2225.  
  2226.     You need to modify RBBS-PC for DBCS operation.  This is rather  easy,  but
  2227.     it requires you to edit the RBBS-PC source  and  recompile  it.   Changing
  2228.     RBBS-PC for DBCS operations, perform the following steps:
  2229.  
  2230.     1.  Change CHR$(227) to CHR$(147)  in  the  source  code  of  all  RBBS-PC
  2231.         modules. 
  2232.     2.  Remove the call "CALL ALLCAPS" in the  subroutine  prompting  for  the
  2233.         MESSAGE SUBJECT.  This call is in line 2065 of RBBS-PC.BAS. 
  2234.     3.  Recompile and link all modules of RBBS-PC. 
  2235.  
  2236.     This method is not the ultimate solution for DBCS  operation,  but  it  is
  2237.     workable.  Running  RBBS-PC  in  a  DBCS  environment  will  make  "thread
  2238.     messages" and selective message reading by entering a search phrase behave
  2239.     erratically.  Some of the RBBS-PC utilities will  not  operate  correctly,
  2240.     either. 
  2241.     My knowledge of Asian languages and their characters is non-existant, so I
  2242.     wouldn't really know how to make this work properly in all cases. 
  2243.     Mr Samson Chen of the New World RBBS in Taipei,  Taiwan  (FIDO  3:720/201)
  2244.     has worked out a method for proper DBCS operation of RBBS-PC.  My  special
  2245.     thanks to him for pointing out a way to get RBBSMail to  run  properly  on
  2246.     DBCS systems. 
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.     Appendix B. DBCS operation                                              35
  2257.  
  2258.  
  2259.  
  2260.     
  2261.  
  2262.  
  2263.     Appendix C. Update history
  2264.  
  2265.  
  2266.     Release of September 25, 1988 - v17.1A. 
  2267.  
  2268.     ■   This version was tested with RBBS-PC v17.A
  2269.     ■   Fixed a few minor bugs in the PATH handling. 
  2270.     ■   Some odd BASIC routines were replaced by assembler subroutines.   This
  2271.         version of RBBSMail should run a little quicker than older ones. 
  2272.     ■   Fixed a bug where RBBSMail would get confused if the TO, FROM or  SUBJ
  2273.         field of a message was blank.  (Which  should  NEVER  happen,  but  it
  2274.         does.)
  2275.     ■   Fixed a problem were RBBSMail would add a blank line to a message each
  2276.         time is was processed by the next node in the Echomail chain. 
  2277.  
  2278.     Release of October 1, 1988 - update of v17.1A. 
  2279.  
  2280.     ■   Fixed (again) an annoying bug in the PATH handling (It seems  I  can't
  2281.         get that one right!)
  2282.  
  2283.     Release of November 22, 1988 - v17.1B
  2284.  
  2285.     ■   Only released to two test sites, you didn't miss it!
  2286.  
  2287.     Release of December 17, 1988 - v17.1C
  2288.  
  2289.     ■   First release of RBBSMail 17.1C, tested with RBBS-PC v17.1C. 
  2290.     ■   Increased the number of EID: tags to 1364 per conference. 
  2291.     ■   Enhanced duplicate message checker. 
  2292.     ■   Can now handle messages up to 25KB in size. 
  2293.     ■   Added a test for message size before TOSSING messages. 
  2294.     ■   Added routines for mail notification in conferences. 
  2295.     ■   Improved error handling. 
  2296.     ■   'Cul-de-Sac' nodes can run in STATIC mode. 
  2297.     ■   Incoming Echomail from points is 'remapped' by RBBSMail. 
  2298.     ■   DEBUG mode for problem error determination. 
  2299.     ■   Ignores comments to sysop while SCANning mail. 
  2300.     ■   Rewrote most of the documentation. 
  2301.  
  2302.     Release of January 6, 1989 - update of v17.1C
  2303.  
  2304.     ■   Sysop's name now properly converted to UPPER case during TOSS. 
  2305.     ■   Sysop's name & alias now properly recognized during SCAN. 
  2306.     ■   Fixed 'mail notification' for sysop's ALIAS. 
  2307.     ■   Fixed hangup when writing .EID file. 
  2308.     ■   Fixed some typos in the DOC. 
  2309.  
  2310.     Release of Januari 12, 1989 - update of v17.1C
  2311.  
  2312.     ■   TOSS now run considerably faster. 
  2313.  
  2314.     Release of April 9, 1989 - v17.2A
  2315.  
  2316.  
  2317.  
  2318.  
  2319.     Appendix C. Update history                                              36
  2320.  
  2321.  
  2322.  
  2323.     
  2324.  
  2325.  
  2326.     ■   Added support for multiple AKA addresses (up to 10)
  2327.     ■   Added ZONE support if used with oMMM v1.40, Binkley 2.00 and Dutchie. 
  2328.     ■   Changed the way in which addresses in AREAS.BBS are handled. 
  2329.     ■   Fixed ERROR 5 bug in USERS file search for flipping mail_wait bit. 
  2330.     ■   Fixed bug in EID: routines that could case hangups. 
  2331.     ■   EID tags now generated if incoming mail has none. 
  2332.     ■   Improved detection of corrupted RBBS-PC MESSAGES files. 
  2333.     ■   Enhanced the "Donald Duck" error handling routines. 
  2334.  
  2335.     Release of September 9, 1989 - v17.2B
  2336.  
  2337.     ■   RBBSMail can now handle 'elastic' MESSAGES files. 
  2338.     ■   Private messages within conferences can now be processed  without  the
  2339.         attribute bits being reset to PUBLIC. 
  2340.  
  2341.     Release of October 18, 1989 - update of v17.2B
  2342.  
  2343.     ■   RBBSMail can now be used in a POINT system. 
  2344.     ■   Double Byte Character Sets are now handled properly  when  some  small
  2345.         changes are made in RBBS-PC. 
  2346.     ■   Added a test for "non standard EID  idiocy"  to  prevent  problems  in
  2347.         duplicate message checking.  Some software writers,  specifically  the
  2348.         authors of XBBS and LYNX have the idea that standards only  exist  for
  2349.         other people.  They have  apparently  decided  that  standard  message
  2350.         formats and standard  EID  tags  should  not  be  generated  by  their
  2351.         software.  May they be sentenced to run DOS 1.00 for the rest of their
  2352.         lifes!
  2353.     ■   Fixed an annoying bug in the duplicate message checking routine. 
  2354.  
  2355.     Release of October 22, 1989 - update of v17.2B
  2356.  
  2357.     ■   It turned out that strictly following the FSC-0001 document as for the
  2358.         exact layout of FIDO compatible messages and mailbundles was not  such
  2359.         a good idea.  The DATE/TIME field of  a  FIDO  message  or  mailbundle
  2360.         should be EXACTLY 20 bytes, and should NOT be padded with  NULL  bytes
  2361.         terminated.   The  891019  release  of  RBBSMail  was  following  this
  2362.         standard  exactly,  but  other  Echomail  processors  appear  to  padd
  2363.         trailing  zeroes  in  the  DATE/TIME  field  of  FIDO   messages   and
  2364.         mailbundles, or use a non-standard DATE/TIME format.  By following the
  2365.         exact standard as described  in  the  FSC-0001  document,  mailbundles
  2366.         build by RBBSMail could not be processed by some of the other Echomail
  2367.         processors. 
  2368.         After exchanging some messages about this with Henk Wevers (of Dutchie
  2369.         fame), I decided that "If you're in Rome, act like  the  Romans".   So
  2370.         RBBSMail does not follow the FSC-0001 standards for  message  packing,
  2371.         but does it the wrong way like oMMM, ConfMail and QMail do. 
  2372.     ■   According to the FSC-0001 document, a FIDO message is  saved  on  disk
  2373.         with a null-terminator as last character.  RBBSMail wrote messages  to
  2374.         disk in this way, but some  message  packers  do  not  test  for  that
  2375.         trailing null character an append a null to every message  they  pack.
  2376.         This results in early termination  of  the  mail  bundle  when  it  is
  2377.         unpacked at the receiving end.  In some cases only the  first  message
  2378.         from a mailbundle will be unpacked and the  remainder  of  the  bundle
  2379.         discarded. 
  2380.  
  2381.  
  2382.     Appendix C. Update history                                              37
  2383.  
  2384.  
  2385.  
  2386.     
  2387.  
  2388.  
  2389.         :br
  2390.         I don't know (and I really don't want to know) how many messages  have
  2391.         gone out in the blue because of the above problems.  Don't complain to
  2392.         me if you have lost messages due to conflicts like the ones  described
  2393.         above.  You're barking up the wrong tree.   RBBSMail  DID  follow  the
  2394.         FSC-0001 standards. 
  2395.  
  2396.         I guess that this about wraps it up for "standards".......... 
  2397.  
  2398.     Release of Januari 8, 1990 - v17.3A
  2399.  
  2400.     ■   Added internal unpacking of mailbundles and archived mailbundles  with
  2401.         the proper unarchive program.  (GUS is recommended). 
  2402.     ■   Added capability  to  TOSS  incoming  Echomail  into  FIDO/OPUS  style
  2403.         message subdirectories.  Dropped the -TU (Toss Unknown) switch, it  is
  2404.         no longer needed. 
  2405.     ■   Added PACK/Renum options for MESSAGES and USERS file maintenance. 
  2406.     ■   Added the -X switch to allow exclusion of tossing the MAIL directory. 
  2407.     ■   Added the -U (UNSAFE!) switch to allow faster tossing of mail. 
  2408.     ■   Added the -N switch to skip user file update. 
  2409.     ■   Added  some  filters  to  handle  non-standard  FIDO  mailbundles  and
  2410.         messages. 
  2411.     ■   Added a filter to handle non-standard EID tags. 
  2412.     ■   Fixed a bug in the translate routines for the PRIVATE net. 
  2413.     ■   Fixed problem with WORKDIR "Rename accross disks". 
  2414.     ■   Fixed bug in the DBCS wordwrap routine. 
  2415.     ■   Fixed improper update of MESSAGES file header records. 
  2416.     ■   Total revision of the documentation. 
  2417.     ■   Massive cleanup of the code.  It is  now  spaghetti  BASIC  with  huge
  2418.         chunks of assembler subroutines.  Anybody  got  a  good  course  on  C
  2419.         language?
  2420.  
  2421.     Release of August 6, 1990 - release of v17.3B
  2422.  
  2423.     ■   Fixed bug where RBBSMail would hang on damaged mailbundles. 
  2424.     ■   Fixed bug in PATH line updating. 
  2425.     ■   Changed the PACK command to MAINT to avoid  confusion  with  the  PACK
  2426.         configuration phrase. 
  2427.     ■   Added maintenance mode for FIDO style message subdirectories. 
  2428.     ■   Added Treshold for renumbering MESSAGES files. 
  2429.     ■   Added NOFORWARD to suppress forwarding of mail to other systems. 
  2430.     ■   Added NOFILES to suppress forwarding of files to other systems. 
  2431.     ■   Added REMAP function for netmail messages to/from points. 
  2432.     ■   Added ZONEGATE function for inter-zone message forwarding. 
  2433.     ■   Messages now have a MSGID: tag added in stead of a EID: tag. 
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.     Appendix C. Update history                                              38
  2446.  
  2447.  
  2448.  
  2449.     
  2450.  
  2451.  
  2452.     Table of Contents
  2453.  
  2454.     1. What is RBBSMail  . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  2455.  
  2456.       1.1  Software Requirements . . . . . . . . . . . . . . . . . . . . . . 1
  2457.       1.2  Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . 2
  2458.       1.3  Related Documents . . . . . . . . . . . . . . . . . . . . . . . . 2
  2459.       1.4  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . 2
  2460.       1.5  Legal stuff . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  2461.       1.6  Copyrights & License  . . . . . . . . . . . . . . . . . . . . . . 3
  2462.       1.7  Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  2463.  
  2464.     2. Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  2465.  
  2466.       2.1  Configuring RBBSMail  . . . . . . . . . . . . . . . . . . . . . . 4
  2467.       2.2  Valid phrases for RBBSMAIL.CFG  . . . . . . . . . . . . . . . . . 4
  2468.         2.2.1  ADDRESS . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2469.         2.2.2  DOMAIN  . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2470.         2.2.3  NETMAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2471.         2.2.4  NETFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2472.         2.2.5  HOLD  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2473.         2.2.6  DUPS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2474.         2.2.7  WORKDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2475.         2.2.8  PRIVATENET  . . . . . . . . . . . . . . . . . . . . . . . . . 6
  2476.         2.2.9  SIZE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  2477.         2.2.10  DBCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  2478.         2.2.11  SYSALIAS . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  2479.         2.2.12  SYSOP  . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  2480.         2.2.13  SECURITY . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  2481.         2.2.14  GATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  2482.         2.2.15  PACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  2483.         2.2.16  UNPACK . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  2484.         2.2.17  ELASTIC  . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  2485.         2.2.18  NOFORWARD  . . . . . . . . . . . . . . . . . . . . . . . . . 8
  2486.         2.2.19  NOFILES  . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  2487.         2.2.20  UNCRASH  . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  2488.         2.2.21  ZONEGATE . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  2489.         2.2.22  Reading BINKLEY.CFG  . . . . . . . . . . . . . . . . . . . . 9
  2490.         2.2.23  Example of a RBBSMAIL.CFG file . . . . . . . . . . . . . .  10
  2491.         2.2.24  Example of an AREAS.BBS file . . . . . . . . . . . . . . .  11
  2492.       2.3  Setting up for POINT operation  . . . . . . . . . . . . . . . .  13
  2493.  
  2494.     3. Running RBBSMail  . . . . . . . . . . . . . . . . . . . . . . . . .  15
  2495.  
  2496.       3.1  MARK mode . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  2497.       3.2  SCAN mode . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  2498.       3.3  TOSS mode . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  2499.       3.4  MAINT mode  . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  2500.  
  2501.     4. A word on RBBS-PC MESSAGES files  . . . . . . . . . . . . . . . . .  23
  2502.  
  2503.       4.1  Filesizes . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  2504.       4.2  Filenames for CONFERENCES . . . . . . . . . . . . . . . . . . .  24
  2505.  
  2506.  
  2507.  
  2508.     Table of Contents                                                       39
  2509.  
  2510.  
  2511.  
  2512.     
  2513.  
  2514.  
  2515.       4.3  Filenames for SUBBOARDS . . . . . . . . . . . . . . . . . . . .  25
  2516.       4.4  Filenames for FIDO style subdirs  . . . . . . . . . . . . . . .  25
  2517.  
  2518.     5. How to set up your mail . . . . . . . . . . . . . . . . . . . . . .  27
  2519.  
  2520.       5.1  What you need . . . . . . . . . . . . . . . . . . . . . . . . .  27
  2521.       5.2  A quick overview  . . . . . . . . . . . . . . . . . . . . . . .  28
  2522.       5.3  Enhanced setup  . . . . . . . . . . . . . . . . . . . . . . . .  28
  2523.       5.4  Zonegate Operation  . . . . . . . . . . . . . . . . . . . . . .  29
  2524.       5.5  Error determination . . . . . . . . . . . . . . . . . . . . . .  29
  2525.       5.6  Other stuff . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  2526.  
  2527.     6. The RBBSNet . . . . . . . . . . . . . . . . . . . . . . . . . . . .  31
  2528.  
  2529.     7. Future enhancements . . . . . . . . . . . . . . . . . . . . . . . .  32
  2530.  
  2531.       7.1  Planned for new releases  . . . . . . . . . . . . . . . . . . .  32
  2532.       7.2  Comments & Suggestions  . . . . . . . . . . . . . . . . . . . .  32
  2533.  
  2534.     Appendix A. Changes to RBBS-PC . . . . . . . . . . . . . . . . . . . .  33
  2535.  
  2536.     Appendix B. DBCS operation . . . . . . . . . . . . . . . . . . . . . .  35
  2537.  
  2538.     Appendix C. Update history . . . . . . . . . . . . . . . . . . . . . .  36
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.     Table of Contents                                                       40
  2572.